SetStructElemSpaceBefore

Tagged PDF, Barrierefreiheit

Beschreibung

Legt das Attribut /SpaceBefore (Eigentümer Layout) am aktuell offenen Strukturelement fest. Der Wert bestimmt den Abstand vor dem Blockelement — entsprechend CSS margin-top oder padding-top. Gleichwertig mit AddTagAttribute mit Owner=Layout, Name=SpaceBefore und dem Zahlenwert als Zeichenfolge

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parameter

Space	Abstand vor dem Element in Standardeinheiten des Benutzerraums, also Punkt mit 1/72 Zoll. Muss ein nicht negativer Wert sein. Der Wert 0 bedeutet keinen zusätzlichen Abstand vor dem Element

Rückgabewert

Gibt bei Erfolg 1 zurück. Gibt 0 zurück, wenn kein Dokument geöffnet oder aktuell kein Tag im Tag-Stapel geöffnet ist.

Anmerkungen

Rufen Sie diese Funktion nach BeginTag oder BeginTagEx und vor EndTag auf. Das Attribut /SpaceBefore ist in ISO 32000-1 §14.8.5.4.2 (Attributinhaber Layout, Tabelle 340) definiert

Layoutattribute (SpaceBefore, SpaceAfter, StartIndent, EndIndent) haben Hinweischarakter: Sie beschreiben das beabsichtigte visuelle Layout für Umbruch- und Export-Engines, beispielsweise wenn ein PDF in HTML oder EPUB umgebrochen wird. Sie wirken sich nicht auf die gerenderte Darstellung des PDF selbst aus. Präzise Layoutattribute verbessern die Qualität der umgebrochenen Ausgabe von Barrierefreiheitswerkzeugen

Beispiel

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

Siehe auch

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute