AddTagAttribute

PDF etiquetado, Accesibilidad

Descripción

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 TPDFlib.AddTagAttribute(Const Owner, Name, Value: WideString): Integer;

ActiveX

Function PDFlib::AddTagAttribute(Owner As String, Name As String, Value As String) As Long

DLL

int DLAddTagAttribute(int InstanceID, const wchar_t * Owner, const wchar_t * Name, const wchar_t * 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. Un solo número se escribe como número PDF y los valores que contienen únicamente números separados por espacios (por ejemplo, `"0 0 200 100"`) se escriben como un arreglo PDF de números reales. Los números usan el punto como separador decimal en todos los sistemas; también se acepta un número escrito con el separador decimal del propio sistema. 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