SetStructElemHeadersA

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 SetStructElemHeaders y los argumentos de cadena se interpretan utilizando la página de códigos SetAnsiMode actual

Establece el atributo /Headers (propietario del atributo Table) en el elemento de estructura abierto actualmente en la pila de etiquetas. El atributo asocia la celda de datos o de encabezado de tabla actual con una o varias celdas de encabezado identificadas por sus identificadores de elemento. Se utiliza para describir estructuras de tabla complejas que no pueden deducirse solo de la posición. Llame a esta función después de BeginTag o BeginTagEx y antes de EndTag

Sintaxis

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

Parámetros

Headers	Una lista de identificadores de elemento, separados por comas, de las celdas TH que actúan como encabezados de columna o fila para la celda TD o TH actual. Cada identificador debe coincidir con un ElemID asignado anteriormente a un elemento TH mediante SetStructElemID en el mismo documento. Se omiten los espacios en blanco alrededor de las comas. Ejemplo: `TH-ProductName,TH-Price`

Valor devuelto

Devuelve 1 si se ejecuta correctamente. Devuelve 0 si no hay ningún documento abierto o ninguna etiqueta abierta en la pila de etiquetas

Observaciones

Esta función equivale a llamar a AddTagAttribute con Owner=Table, Name=Headers y la misma lista de identificadores separados por comas como Value. El atributo se escribe como una matriz /Headers de cadenas de texto PDF en el diccionario de atributos /A del elemento de estructura

El atributo /Headers se define en ISO 32000-1 §14.8.5.7.2 (propietario del atributo Table). En tablas sencillas donde los encabezados de columna están directamente encima de sus celdas de datos, el atributo /Scope establecido mediante SetStructElemScope suele ser suficiente. Utilice /Headers para tablas irregulares con celdas combinadas o encabezados de varios niveles

PDF/UA-1 (ISO 14289-1 §7.10) exige que cada celda TD esté asociada explícitamente a sus celdas de encabezado en las tablas donde la asociación no pueda determinarse únicamente a partir del orden de lectura

Ejemplo

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Véase también

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode