SetStructElemListNumberingA

Tagged PDF, Dostępność

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w SetStructElemListNumbering, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Ustawia atrybut /ListNumbering (właściciel atrybutów List) w elemencie struktury aktualnie otwartym na stosie tagów. Wartość deklaruje schemat znacznika lub numeracji używany dla elementów struktury L (lista), umożliwiając technologii asystującej poprawne ogłoszenie typu listy. Odpowiada wywołaniu AddTagAttribute z Owner=List, Name=ListNumbering i nazwą schematu jako wartością

Składnia

Delphi

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

DLL

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

Parametry

NumberingSchemat numeracji listy. Musi być jedną z poniższych wartości (z rozróżnianiem wielkości liter):

None — bez widocznego znacznika (domyślnie, gdy atrybutu brakuje)
Disc — wypełnione koło (•)
Circle — puste koło (○)
Square — wypełniony kwadrat (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Wartość zwracana

Zwraca 1 w przypadku powodzenia. Zwraca 0, jeżeli żaden dokument nie jest otwarty albo stos znaczników nie zawiera obecnie otwartego znacznika

Uwagi

Wywołaj tę funkcję po BeginTag z typem tagu L (lista), a przed EndTag. Atrybut /ListNumbering zdefiniowano w ISO 32000-1 §14.8.5.3.2 (właściciel atrybutów List, tabela 336)

Atrybut dotyczy zawierającego elementu L, a nie poszczególnych elementów LI. Ustaw go jednokrotnie w elemencie L bezpośrednio po jego otwarciu. Atrybut ma charakter informacyjny: wskazuje technologiom asystującym rodzaj listy, aby mogły ogłosić "listę punktowaną", "listę numerowaną" itd. — niezależnie od tego, jakie wizualne glify znaczników rzeczywiście narysował renderer PDF

Gdy lista nie ma jawnego systemu numeracji (na przykład jest serią terminów bez widocznych punktorów), użyj None albo całkowicie pomiń atrybut

Przykład

// 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

Zobacz również

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics