SetStructElemListNumbering

Tagged PDF, Dostępność

Opis

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 TPDFlib.SetStructElemListNumbering(Const Numbering: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemListNumbering(Numbering As String) As Long

DLL

int DLSetStructElemListNumbering(int InstanceID, const wchar_t * 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