SetStructElemSpaceBefore

Tagged PDF, Přístupnost

Popis

Sets the /SpaceBefore attribute (Layout attribute owner) on the structure element currently open on the tag stack. The value specifies the amount of space to add before the block-level element — analogous to CSS margin-top or padding-top. Equivalent to calling AddTagAttribute with Owner=Layout, Name=SpaceBefore, and the numeric value as a string.

Syntaxe

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parametry

Space	Mezera před elementem v jednotkách default user space (body, 1/72 palce). Musí být nezáporná hodnota. Hodnota 0 znamená žádnou extra mezeru před elementem

Návratová hodnota

Při úspěchu vrací 1. Vrací 0, pokud není otevřený žádný dokument nebo žádný tag v zásobníku tagů

Poznámky

Call this function after BeginTag or BeginTagEx and before EndTag. The /SpaceBefore attribute is defined in ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, Table 340).

Layoutové atributy (SpaceBefore, SpaceAfter, StartIndent, EndIndent) jsou poradní: popisují zamýšlený vizuální layout pro re-flow a exportní enginy (například když se PDF přelévá do HTML nebo EPUB). Na vykreslený vzhled samotného PDF nemají vliv. Přesné layoutové atributy zlepší kvalitu přetékajícího výstupu z accessibility nástrojů

Příklad

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

Viz také

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute