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);

參數

NumberingThe list numbering scheme. Must be one of the following values (case-sensitive):

None — no visible marker (default when attribute is absent)
Disc — filled circle (•)
Circle — open circle (○)
Square — filled square (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

傳回值

成功傳回 1。沒有開啟的文件，或標籤堆疊上沒有開啟中的標籤時傳回 0

備註

請在標籤類型為 L（list）的 BeginTag 之後、EndTag 之前呼叫此函式。/ListNumbering 屬性定義於 ISO 32000-1 §14.8.5.3.2（List attribute owner，表 336）。

屬性適用於包含它的 L 元素，而不是一個個 LI 項目。請在開啟 L 元素後立即設定一次。此屬性是建議性質：告訴輔助技術這是哪種清單，讓它能播報「項目符號清單」、「編號清單」等 — 與 PDF render 實際畫出的視覺記號字形無關。

清單沒有明確編號方式時（例如一串沒有視覺項目符號的詞條），請用 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