SetStructElemSpaceBefore

PDF etichetat, Accesibilitate

Descriere

Setează atributul /SpaceBefore (deținător de atribute Layout) pe elementul de structură deschis curent pe stiva de taguri. Valoarea specifică spațiul de adăugat înaintea elementului de nivel de bloc — analog cu CSS margin-top sau padding-top. Echivalent cu apelarea AddTagAttribute cu Owner=Layout, Name=SpaceBefore și valoarea numerică ca șir

Sintaxă

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	Spațiu înaintea elementului, în unități user space implicite (puncte, 1/72 inch). Trebuie să fie o valoare nenegativă. Valoarea 0 înseamnă fără spațiu suplimentar înaintea elementului

Valoare returnată

Returnează 1 în caz de succes. Returnează 0 dacă niciun document nu este deschis sau dacă nu există niciun tag deschis în stiva de tag-uri

Observații

Apelați această funcție după BeginTag sau BeginTagEx și înainte de EndTag. Atributul /SpaceBefore este definit în ISO 32000-1 §14.8.5.4.2 (deținător de atribute Layout, Table 340)

Atributele de layout (SpaceBefore, SpaceAfter, StartIndent, EndIndent) sunt indicative: descriu layout-ul vizual intenționat pentru motoarele de re-flow și export (de exemplu, când un PDF este re-fluxat în HTML sau EPUB). Nu afectează aspectul randat al PDF-ului în sine. Furnizarea unor atribute de layout precise îmbunătățește calitatea ieșirii re-fluxate a uneltelor de accesibilitate

Exemplu

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

Consultați și

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute