SetStructElemColSpan

PDF etiquetado, Accesibilidad

Descripción

Establece el atributo /ColSpan (propietario del atributo Table) en el elemento de estructura abierto actualmente en la pila de etiquetas. El valor indica cuántas columnas abarca la celda de tabla actual. Equivale a llamar a AddTagAttribute con Owner=Table, Name=ColSpan y el valor entero como cadena

Sintaxis

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parámetros

ColSpan	El número de columnas que abarca la celda de tabla actual Debe ser un entero positivo Un valor de 1 significa que la celda ocupa exactamente una columna (comportamiento predeterminado cuando no se establece ColSpan) Los valores mayores que 1 indican una celda de encabezado o de datos que abarca varias columnas

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 o TD) y antes de EndTag. El atributo /ColSpan se define en ISO 32000-1 §14.8.5.7.2 (propietario del atributo Table, Tabla 337)

Las celdas que abarcan varias columnas son comunes en tablas complejas; por ejemplo, un encabezado de columna que abarca dos columnas de datos Proporcionar el atributo /ColSpan permite a la tecnología de asistencia calcular correctamente las posiciones de celda y asociar encabezados con celdas de datos en toda la cuadrícula de la tabla

Cuando una celda también abarque varias filas, use SetStructElemRowSpan junto con esta función

Ejemplo

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

Véase también

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag