SetStructElemScopeA

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

Establece el atributo /Scope (propietario del atributo Table) en el elemento de estructura abierto actualmente en la pila de etiquetas. El ámbito identifica si una celda TH (encabezado de tabla) se aplica a una columna, una fila o ambas, como exige PDF/UA-1 para tablas con celdas de encabezado. Equivale a llamar a AddTagAttribute con Owner=Table, Name=Scope y el nombre del ámbito como valor

Sintaxis

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

Parámetros

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

Llame después de BeginTag (tipo TH) y antes de EndTag. /Scope se define en ISO 32000-1 §14.8.5.7.2

PDF/UA-1 (ISO 14289-1 §7.10) exige que las celdas de encabezado de tabla se asocien claramente con sus celdas de datos. Proporcionar el atributo /Scope es el mecanismo recomendado cuando lo permite el diseño de la tabla

Ejemplo

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Véase también

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode