SetStructElemColSpan

PDF etiquetado, Accesibilidad

Descripción

Establece /ColSpan en el elemento actual, indicando columnas abarcadas. Equivale a AddTagAttribute con Owner=Table, Name=ColSpan y 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. El valor 1 significa que la celda ocupa exactamente una columna (comportamiento predeterminado cuando no se establece ColSpan). Los valores superiores a 1 indican una celda de encabezado o datos que abarca varias columnas

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 tras BeginTag con TH o TD y antes de EndTag. /ColSpan se define en ISO 32000-1 §14.8.5.7.2

Las celdas expandidas son habituales; /ColSpan permite a tecnología asistencial calcular posiciones y asociar cabeceras con datos en toda la cuadrícula

Cuando una celda también abarque varias filas, utilice 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