AddTagAttributeA

PDF etiquetado, Accesibilidad

Descripción

El sufijo A indica el punto de entrada ANSI (char) de la DLL; la superficie ActiveX/COM expone únicamente la forma Unicode. El comportamiento es idéntico a AddTagAttribute y los argumentos de cadena se interpretan utilizando la página de códigos SetAnsiMode actual

Añade un atributo con nombre al elemento de estructura que se está creando en la pila de etiquetas. El atributo se escribe como un diccionario de atributos PDF /A (o una matriz de diccionarios) al guardar el documento. Llame a esta función después de BeginTag o BeginTagEx y antes de EndTag

Sintaxis

Delphi

Function DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;

DLL

int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * Value);

Parámetros

Owner	Nombre del propietario definido en ISO 32000-1 Tabla 348, p. ej., `Layout`, `Table`, `List`, `PrintField`; pasa a ser `/O`
Name	El nombre del atributo del propietario indicado (p. ej., `BBox` para Layout o `Scope` para Table). No debe estar vacío
Value	El valor del atributo como cadena. Los valores que solo contienen números separados por espacios (por ejemplo, `"0 0 200 100"`) se escriben como una matriz PDF de números reales. Cualquier otro valor se escribe como un objeto de nombre PDF (sin `/` inicial). No debe estar vacío

Valor devuelto

Devuelve 1 en caso de éxito. Devuelve 0 si no hay ningún documento abierto, no hay ninguna etiqueta abierta actualmente o Owner o Name están vacíos

Observaciones

Se acumulan varias llamadas a AddTagAttribute para la misma etiqueta abierta. Cuando los atributos pertenecen a un solo propietario, la biblioteca escribe un único diccionario de atributos /A. Cuando se utilizan varios propietarios, los atributos se agrupan por propietario y se escriben como una matriz de diccionarios

Para los atributos comunes, pueden utilizarse los contenedores prácticos SetStructElemScope y SetStructElemBBox en lugar de llamar directamente a AddTagAttribute

Los atributos se restablecen al abrir una etiqueta nueva; los elementos hijos no los heredan

Ejemplo

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

Véase también

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox