SetStructElemListNumberingA

タグ付き PDF、アクセシビリティ

説明

末尾の A は ANSI（char）DLL エントリポイントを示し、ActiveX/COM の表面では Unicode 形式のみ公開される。動作は SetStructElemListNumbering と同一で、文字列引数は現在の SetAnsiMode コードページを使って解釈される

タグスタックで現在開いている構造要素に /ListNumbering 属性 (List 属性所有者) を設定します。この値は L (リスト) 構造要素内の項目に使用するマーカーまたは番号付け方式を宣言し、支援技術がリストタイプを正しく読み上げられるようにします。AddTagAttribute を Owner=List、Name=ListNumbering、方式名を値として指定して呼び出すことと同等です

構文

Delphi

Function DLSetStructElemListNumberingA(InstanceID: Integer; Numbering: PAnsiChar): Integer;

DLL

int DLSetStructElemListNumberingA(int InstanceID, const char * Numbering);

パラメータ

Numberingリスト番号付けスキームです。次のいずれかの値である必要があります (大文字小文字を区別します):

None — 可視マーカーなし (属性がない場合の既定)
Disc — 塗りつぶし円 (•)
Circle — 中空円 (○)
Square — 塗りつぶし四角 (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

戻り値

成功時は 1 を返します。文書が開かれていない場合、またはタグスタックで現在開かれているタグがない場合は 0 を返します

備考

BeginTag をタグタイプ L（リスト）で呼び出した後、EndTag の前にこの関数を呼び出します。/ListNumbering 属性は ISO 32000-1 §14.8.5.3.2（List 属性所有者、Table 336）で定義されています

この属性は包含する L 要素に適用され、個々の LI 項目には適用されません。開いた直後に L 要素へ一度設定してください。この属性は補助的なものであり、PDF レンダラーが実際に描画した視覚マーカーグリフにかかわらず、リストの種類を支援技術に伝えて「箇条書きリスト」や「番号付きリスト」などと通知できるようにします

リストに明示的な番号付け方式がない場合（視覚的な箇条書きなしで並ぶ用語など）は、None を使用するか属性自体を省略します

例

// An ordered decimal list
PDFlib.BeginTag('L', '', '', '');
PDFlib.SetStructElemListNumbering('Decimal');

  PDFlib.BeginTag('LI', '', '', '');
    PDFlib.BeginTag('Lbl', '', '', '');
    PDFlib.DrawText('1.', 72, 700);
    PDFlib.EndTag;
    PDFlib.BeginTag('LBody', '', '', '');
    PDFlib.DrawText('First item', 90, 700);
    PDFlib.EndTag;
  PDFlib.EndTag;

  PDFlib.BeginTag('LI', '', '', '');
    PDFlib.BeginTag('Lbl', '', '', '');
    PDFlib.DrawText('2.', 72, 680);
    PDFlib.EndTag;
    PDFlib.BeginTag('LBody', '', '', '');
    PDFlib.DrawText('Second item', 90, 680);
    PDFlib.EndTag;
  PDFlib.EndTag;

PDFlib.EndTag; // L

関連項目

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics