SetStructElemSpaceBefore

Tagged PDF, Accessibility

Description

在标记栈上当前打开的结构元素上设置 /SpaceBefore 属性（布局属性所有者）；该值指定在块级元素之前添加的空间量 — 类似于 CSS 的 margin-top 或 padding-top；等效于以 Owner=Layout、Name=SpaceBefore 并且将数值作为字符串调用 AddTagAttribute

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parameters

Space	在默认用户空间单位（磅，1/72 英寸）中，元素之前的空间量；必须为非负值，值为 0 表示元素之前没有额外空间

Return value

成功时返回 1；如果未打开任何文档或标记栈上当前未打开任何标记，则返回 0

Remarks

在 BeginTag 或 BeginTagEx 之后以及 EndTag 之前调用此函数；/SpaceBefore 属性在 ISO 32000-1 §14.8.5.4.2（布局属性所有者，表 340）中定义

布局属性（SpaceBefore、SpaceAfter、StartIndent、EndIndent）是建议性的：它们描述了用于重排和导出引擎（例如，当 PDF 重排为 HTML 或 EPUB 时）的目标视觉布局；它们不会影响 PDF 本身的渲染外观；提供准确的布局属性可提高无障碍工具重排输出的质量

Example

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