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