SetStructElemScopeA

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

Establece el atributo /Scope (propietario de atributos Table) en el elemento de estructura abierto actualmente en la pila de etiquetas. El alcance 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 alcance como valor

Sintaxis

Delphi

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

DLL

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

Parámetros

Scope	El ámbito de la celda de encabezado Debe ser uno de los siguientes valores (distingue mayúsculas y minúsculas): Column — el encabezado se aplica a todas las celdas de la columna Row — el encabezado se aplica a todas las celdas de la fila Both — el encabezado se aplica tanto a la columna como a la fila

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

Llame a esta función después de BeginTag (con tipo de etiqueta TH) y antes de EndTag. El atributo /Scope se define en ISO 32000-1 §14.8.5.7.2 (propietario de atributo Table)

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 el diseño de la tabla lo permite

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