SetStructElemSpaceBefore

Структурированный PDF, Доступность

Описание

Задаёт атрибут /SpaceBefore (Layout attribute owner) у структурного элемента, открытого сейчас на стеке тегов. Значение указывает величину отступа, добавляемого перед блочным элементом — аналог 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 attribute owner, таблица 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