AddTagAttribute

PDF etiquetado, Accesibilidad

Descripción

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 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	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. Un único número se escribe como número PDF y 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. Los números usan el punto como separador decimal en todos los sistemas; un número escrito con el separador decimal propio del sistema también se acepta. 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