SetStructElemSpaceBefore

Маркиран PDF, достъпност

Описание

Задава атрибута /SpaceBefore (собственик на атрибути Layout) върху структурния елемент, който в момента е отворен в стека на таговете. Стойността указва количеството пространство, което да се добави преди блоковия елемент — аналогично на CSS margin-top или padding-top. Еквивалентно е на извикване на AddTagAttribute с Owner=Layout, Name=SpaceBefore и числовата стойност като низ

Синтаксис

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Параметри

Space	Пространство преди елемента в стандартните единици на потребителското пространство (точки, 1/72 инча). Трябва да е неотрицателна стойност. Стойност 0 означава, че няма допълнително пространство преди елемента

Върната стойност

Връща 1 при успех. Връща 0, ако не е отворен документ или в стека с етикети няма отворен етикет

Забележки

Извикайте тази функция след BeginTag или BeginTagEx и преди EndTag. Атрибутът /SpaceBefore е дефиниран в ISO 32000-1 §14.8.5.4.2 (собственик на атрибути Layout, Таблица 340)

Атрибутите за оформление (SpaceBefore, SpaceAfter, StartIndent, EndIndent) са препоръчителни: те описват предвиденото визуално оформление за механизмите за пренареждане и експортиране (например когато PDF се пренарежда към HTML или EPUB). Те не влияят на визуалния вид на самия PDF. Предоставянето на точни атрибути за оформление подобрява качеството на пренареденото изходно съдържание от помощните инструменти

Пример

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

Вижте също

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute