AddTagAttributeA
PDF etiquetado, Accesibilidad
Descripción
La A final indica el punto de entrada ANSI (char) de la DLL; la interfaz 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 actual de SetAnsiMode
Agrega 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) cuando se guarda el documento. Llama a BeginTag o BeginTagEx 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 | El nombre del propietario de atributo definido en ISO 32000-1 Table 348 (por ejemplo, Layout, Table, List, PrintField). Se convierte en la clave /O del diccionario de atributos |
|---|---|
| Name | El nombre de atributo para el propietario dado (por ejemplo, BBox para Layout, Scope para Table). No debe estar vacío |
| Value | El valor del atributo como cadena. Los valores que contienen solo números separados por espacios (por ejemplo, "0 0 200 100") se escriben como un arreglo PDF de números reales. Cualquier otro valor se escribe como un objeto de nombre PDF (sin un / 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á vacío
Observaciones
Las llamadas múltiples a AddTagAttribute para la misma etiqueta abierta se acumulan. Cuando los atributos pertenecen a un único propietario, la biblioteca escribe un único diccionario de atributos /A. Cuando se usan varios propietarios, los atributos se agrupan por propietario y se escriben como una matriz de diccionarios de atributos
Para atributos comunes, se pueden usar los envoltorios de conveniencia SetStructElemScope y SetStructElemBBox en lugar de llamar directamente a AddTagAttribute
Los atributos se restablecen al abrir una etiqueta nueva; los elementos secundarios 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