SetStructElemSpaceBefore

Taggad PDF, tillgänglighet

Beskrivning

Sätter attributet /SpaceBefore (Layout-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Värdet anger mängden mellanrum som ska läggas före blocknivåelementet — analogt med CSS margin-top eller padding-top. Ekvivalent med att anropa AddTagAttribute med Owner=Layout, Name=SpaceBefore och det numeriska värdet som sträng

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parametrar

Space	Mellanrum före elementet i user space-standardenheter (punkter, 1/72 tum). Måste vara ett icke-negativt värde. Värdet 0 betyder inget extra mellanrum före elementet

Returvärde

Returnerar 1 vid lyckat anrop. Returnerar 0 om inget dokument är öppet eller om ingen tagg för tillfället ligger överst på taggstacken

Anmärkningar

Anropa den här funktionen efter BeginTag eller BeginTagEx och före EndTag. Attributet /SpaceBefore är definierat i ISO 32000-1 §14.8.5.4.2 (Layout-attributägare, tabell 340)

Layoutattribut (SpaceBefore, SpaceAfter, StartIndent, EndIndent) är vägledande: de beskriver den avsedda visuella layouten för re-flow- och exportmotorer (till exempel när en PDF flödas om till HTML eller EPUB). De påverkar inte PDF:ens egen renderade utseende. Att ange korrekta layoutattribut förbättrar kvaliteten på omflödad utdata från tillgänglighetsverktyg

Exempel

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

Se även

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute