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