SetStructElemRowSpan

PDF etiquetado, Accesibilidad

Descripción

Establece el atributo /RowSpan (propietario de atributo Table) en el elemento de estructura abierto actualmente en la pila de etiquetas El valor indica cuántas filas abarca la celda actual de la tabla 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 mayores que 1 indican una celda que abarca varias filas

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 el tipo de etiqueta TH o TD) y antes de EndTag; el atributo /RowSpan está definido en ISO 32000-1 §14.8.5.7.2 (propietario de atributos de tabla, Tabla 337)

Las celdas que abarcan filas aparecen en tablas cuando una celda de encabezado o 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 la tecnología de asistencia construya correctamente el modelo de cuadrícula lógica de la tabla

Cuando una celda también abarca varias columnas, use SetStructElemColSpan en combinación 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