SetStructElemSpaceBefore

PDF etiquetado, Accesibilidad

Descripción

Establece el atributo /SpaceBefore (propietario del atributo Layout) en el elemento de estructura abierto actualmente en la pila de etiquetas. El valor especifica la cantidad de espacio que se agrega 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 de espacio de usuario (puntos, 1/72 de pulgada). Debe ser un valor no negativo. Un valor de 0 significa que no hay espacio adicional antes del elemento

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 o BeginTagEx y antes de EndTag. El atributo /SpaceBefore está definido en ISO 32000-1 §14.8.5.4.2 (propietario de atributos de diseño, tabla 340)

Los atributos Layout (SpaceBefore, SpaceAfter, StartIndent, EndIndent) son informativos: describen el diseño visual previsto para los motores de reflujo y exportación (por ejemplo, cuando un PDF se refluje a HTML o EPUB). No afectan la apariencia representada del propio PDF. Proporcionar atributos de diseño precisos mejora la calidad de la salida reflujada de 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