SetStructElemSpaceBefore

Tagged PDF, Dostępność

Opis

Ustawia atrybut /SpaceBefore (właściciel atrybutów Layout) w elemencie struktury aktualnie otwartym na stosie tagów. Wartość określa ilość miejsca dodawanego przed elementem blokowym — analogicznie do CSS margin-top lub padding-top. Odpowiada wywołaniu AddTagAttribute z Owner=Layout, Name=SpaceBefore i wartością liczbową zapisaną jako ciąg

Składnia

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	Miejsce przed elementem w domyślnych jednostkach przestrzeni użytkownika (punkty, 1/72 cala). Musi być wartością nieujemną. Wartość 0 oznacza brak dodatkowego miejsca przed elementem

Wartość zwracana

Zwraca 1 w przypadku powodzenia. Zwraca 0, jeżeli żaden dokument nie jest otwarty albo stos znaczników nie zawiera obecnie otwartego znacznika

Uwagi

Wywołaj tę funkcję po BeginTag lub BeginTagEx, a przed EndTag. Atrybut /SpaceBefore zdefiniowano w ISO 32000-1 §14.8.5.4.2 (właściciel atrybutów Layout, tabela 340)

Atrybuty układu (SpaceBefore, SpaceAfter, StartIndent, EndIndent) mają charakter informacyjny: opisują zamierzony układ wizualny dla mechanizmów zmiany układu i eksportu (na przykład podczas przekształcania układu PDF do HTML lub EPUB). Nie wpływają na wyrenderowany wygląd samego pliku PDF. Dokładne atrybuty układu poprawiają jakość wyniku po zmianie układu przez narzędzia dostępności

Przykład

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

Zobacz również

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute