SetStructElemSpaceBefore

Tagged PDF, Tilgængelighed

Beskrivelse

Angiver attributten /SpaceBefore (Layout-attributindehaver) på det strukturelement, der aktuelt er åbent på tagstakken. Værdien angiver den mængde plads, der skal tilføjes før elementet på blokniveau — svarende til CSS margin-top eller padding-top. Svarer til at kalde AddTagAttribute med Owner=Layout, Name=SpaceBefore og den numeriske værdi som en streng.

Syntaks

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parametre

Space	Afstand før elementet i standardenheder for brugerrummet (punkter, 1/72 tomme). Skal være en ikke-negativ værdi. Værdien 0 betyder, at der ikke er ekstra afstand før elementet.

Returværdi

Returnerer 1 ved succes. Returnerer 0, hvis intet dokument er åbent, eller intet tag aktuelt er åbent på tagstakken

Bemærkninger

Kald denne funktion efter BeginTag eller BeginTagEx og før EndTag. Attributten /SpaceBefore er defineret i ISO 32000-1 §14.8.5.4.2 (Layout-attributindehaver, Table 340).

Layoutattributter (SpaceBefore, SpaceAfter, StartIndent, EndIndent) er vejledende: de beskriver det tilsigtede visuelle layout for ombrydnings- og eksportmotorer (f.eks. når en PDF ombrydes til HTML eller EPUB). De påvirker ikke selve PDF'ens gengivne udseende. Nøjagtige layoutattributter forbedrer kvaliteten af ombrudt output fra tilgængelighedsværktøjer.

Eksempel

// 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 også

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute