SetStructElemRowSpan

PDF etiquetado, Accesibilidad

Descripción

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

Sintaxis

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parámetros

RowSpanEl número de filas que abarca la celda de tabla actual. Debe ser un entero positivo. Un valor de 1 significa que la celda ocupa exactamente una fila (comportamiento predeterminado cuando no se establece RowSpan). Los valores superiores a 1 indican una celda que abarca varias filas

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. /RowSpan se define en ISO 32000-1 §14.8.5.7.2

Las celdas que abarcan varias filas aparecen en tablas en las que una celda de encabezado o de datos debe extenderse verticalmente por varias filas — por ejemplo, un encabezado de fila compartido por varias filas de datos. Proporcionar el atributo /RowSpan permite que las tecnologías de asistencia construyan correctamente el modelo de cuadrícula lógica de la tabla

Cuando una celda también abarca varias columnas, utilice SetStructElemColSpan junto con esta función

Ejemplo

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

Véase también

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag