SetStructElemSpaceBefore

Getagde PDF, toegankelijkheid

Beschrijving

Zet het attribuut /SpaceBefore (Layout-attribuuteigenaar) op het structuurelement dat momenteel open staat op de tagstack. De waarde geeft de ruimte aan die vóór het blokelement moet worden toegevoegd — vergelijkbaar met CSS margin-top of padding-top. Gelijk aan het aanroepen van AddTagAttribute met Owner=Layout, Name=SpaceBefore en de numerieke waarde als string

Syntaxis

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parameters

Space	Ruimte vóór het element, in standaard user space-eenheden (punten, 1/72 inch). Moet een niet-negatieve waarde zijn. Een waarde van 0 betekent geen extra ruimte vóór het element

Retourwaarde

Retourneert 1 bij succes. Retourneert 0 als er geen document is geopend of momenteel geen tag op de tagstack geopend is

Opmerkingen

Roep deze functie aan na BeginTag of BeginTagEx en vóór EndTag. Het attribuut /SpaceBefore is gedefinieerd in ISO 32000-1 §14.8.5.4.2 (Layout-attribuuteigenaar, Table 340)

Layout-attributen (SpaceBefore, SpaceAfter, StartIndent, EndIndent) zijn adviserend: ze beschrijven de beoogde visuele layout voor re-flow- en exportengines (bijvoorbeeld wanneer een PDF naar HTML of EPUB wordt omgezet). Ze hebben geen invloed op het gerenderde uiterlijk van de PDF zelf. Nauwkeurige layout-attributen verbeteren de kwaliteit van de omgezette uitvoer van accessibilitytools

Voorbeeld

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

Zie ook

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute