SetStructElemSpaceBefore

Tagged PDF, Pristupačnost

Opis

Postavlja atribut /SpaceBefore (vlasnik atributa: Layout) na strukturni element trenutno otvoren na steku oznaka. Vrednost određuje količinu prostora koja se dodaje pre elementa na nivou bloka — analogno CSS margin-top ili padding-top. Ekvivalentno pozivu AddTagAttribute sa Owner=Layout, Name=SpaceBefore i numeričkom vrednošću kao string.

Sintaksa

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parametri

Space	Prostor pre elementa u jedinicama podrazumevanog korisničkog prostora (tačke, 1/72 inča). Mora biti nenegativna vrednost. Vrednost 0 znači da nema dodatnog prostora pre elementa

Povratna vrednost

Vraća 1 u slučaju uspeha. Vraća 0 ako nijedan dokument nije otvoren ili ako nijedan tag nije trenutno otvoren na steku tagova

Napomene

Pozovite ovu funkciju nakon BeginTag ili BeginTagEx i pre EndTag. Atribut /SpaceBefore definisan je u ISO 32000-1 §14.8.5.4.2 (vlasnik atributa Layout, Tabela 340).

Atributi rasporeda (SpaceBefore, SpaceAfter, StartIndent, EndIndent) su savetodavni: opisuju namenjeni vizuelni raspored za motore preusmeravanja i izvoza (na primer kada se PDF preusmerava u HTML ili EPUB). Ne utiču na izgled samog PDF-a. Davanje tačnih atributa rasporeda poboljšava kvalitet preusmerenog izlaza alata za pristupačnost

Primer

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

Vidi takođe

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute