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