SetStructElemSpaceBefore

PDF balisé, accessibilité

Description

Définit /SpaceBefore (propriétaire Layout) sur l’élément ouvert. La valeur indique l’espace avant le bloc, analogue à CSS margin-top ou padding-top. Équivaut à AddTagAttribute avec Owner=Layout, Name=SpaceBefore et la valeur numérique comme chaîne

Syntaxe

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Paramètres

Space	Espace avant l'élément en unités utilisateur par défaut, points, 1/72 pouce. Doit être non négatif ; 0 signifie aucun espace supplémentaire

Valeur de retour

Renvoie 1 en cas de réussite Renvoie 0 si aucun document n'est ouvert ou si aucune balise n'est actuellement ouverte sur la pile de balises

Remarques

Appelez cette fonction après BeginTag ou BeginTagEx et avant EndTag. L’attribut /SpaceBefore est défini dans ISO 32000-1 §14.8.5.4.2 (propriétaire d’attribut Layout, tableau 340)

Les attributs de mise en page SpaceBefore, SpaceAfter, StartIndent et EndIndent sont indicatifs : ils décrivent la disposition voulue pour les moteurs de redistribution et d’exportation, par exemple vers HTML ou EPUB. Ils n’affectent pas le rendu du PDF. Des valeurs exactes améliorent la qualité des sorties redistribuées par les outils d’accessibilité

Exemple

// 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;

Voir aussi

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute