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