SetStructElemSpaceBefore

PDF etiquetado, Accesibilidad

Descripción

Establece el atributo /SpaceBefore (propietario de atributo Layout) en el elemento de estructura abierto actualmente en la pila de etiquetas. El valor especifica la cantidad de espacio que se añadirá antes del elemento de nivel de bloque, análoga a CSS margin-top o padding-top. Equivale a llamar a AddTagAttribute con Owner=Layout, Name=SpaceBefore y el valor numérico como cadena

Sintaxis

Delphi

Function TPDFlib.SetStructElemSpaceBefore(Space: Double): Integer;

ActiveX

Function PDFlib::SetStructElemSpaceBefore(Space As Double) As Long

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parámetros

Space	Espacio antes del elemento en unidades predeterminadas del espacio de usuario (puntos, 1/72 de pulgada). Debe ser un valor no negativo. El valor 0 significa que no hay espacio adicional antes del elemento

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 a esta función después de BeginTag o BeginTagEx y antes de EndTag. El atributo /SpaceBefore se define en ISO 32000-1 §14.8.5.4.2 (propietario del atributo Layout, Table 340)

Los atributos de diseño (SpaceBefore, SpaceAfter, StartIndent, EndIndent) son orientativos: describen la disposición visual prevista para los motores de redistribución y exportación (por ejemplo, cuando un PDF se redistribuye a HTML o EPUB). No afectan a la apariencia renderizada del propio PDF. Facilitar atributos de diseño precisos mejora la calidad de la salida redistribuida por las herramientas de accesibilidad

Ejemplo

// Tag a heading with extra space above it
PDFlib.BeginTag('H1', '', '', '');
PDFlib.SetStructElemSpaceBefore(12.0);  // 12 pt above the heading
PDFlib.DrawText('Introduction', 72, 700);
PDFlib.EndTag;

Véase también

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute