SetStructElemHeadersA

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

Establece el atributo /Headers, propietario de atributos Table, en el elemento de estructura abierto actualmente en la pila de etiquetas. El atributo asocia la celda de datos o encabezado de tabla actual con una o más celdas de encabezado identificadas por sus ID de elemento. Se usa para describir estructuras de tabla complejas que no pueden inferirse solo por la posición. Llame a esto 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	Lista separada por comas de IDs de elemento de las celdas TH que son encabezados de columna o fila para la celda TD o TH actual. Cada ID debe coincidir con un ElemID asignado antes a un elemento TH mediante SetStructElemID en el mismo documento. Se ignoran los espacios alrededor de las comas. Ejemplo: `TH-ProductName,TH-Price`

Valor devuelto

Devuelve 1 si tiene éxito Devuelve 0 si no hay un documento abierto o si no hay ninguna etiqueta abierta actualmente en la pila de etiquetas

Observaciones

Esta función equivale a llamar a AddTagAttribute con Owner=Table, Name=Headers y la misma lista de ID separada por comas que 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 está definido en ISO 32000-1 §14.8.5.7.2 (propietario del atributo Table). Para tablas simples cuyos encabezados de columna están directamente sobre sus celdas de datos, suele ser suficiente el atributo /Scope establecido mediante SetStructElemScope. Use /Headers para tablas irregulares con celdas que abarcan varias posiciones o encabezados de varios niveles

PDF/UA-1 (ISO 14289-1 §7.10) exige que cada celda TD se asocie explícitamente con sus celdas de encabezado en tablas donde la asociación no pueda determinarse solo 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