SetStructElemListNumberingA

PDF con tag, accessibilità

Descrizione

Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a SetStructElemListNumbering e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

Imposta /ListNumbering (proprietario List) sull'elemento aperto, dichiarando lo schema degli elementi L. Equivale a AddTagAttribute con Owner=List, Name=ListNumbering e nome dello schema

Sintassi

Delphi

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

DLL

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

Parametri

NumberingSchema di numerazione dell'elenco. Deve essere uno dei valori seguenti, con distinzione tra maiuscole e minuscole:

None — nessun marcatore visibile (impostazione predefinita quando l'attributo è assente)
Disc — cerchio pieno (•)
Circle — cerchio vuoto (○)
Square — quadrato pieno (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun documento o tag è attualmente aperto

Note

Chiamare dopo BeginTag con tag L e prima di EndTag. /ListNumbering è definito in ISO 32000-1 §14.8.5.3.2 (proprietario List, Tabella 336)

L'attributo si applica all'elemento L contenitore, non ai singoli elementi LI. Impostarlo una sola volta sull'elemento L subito dopo averlo aperto. L'attributo è indicativo: comunica alle tecnologie assistive il tipo di elenco affinché possano annunciare "elenco puntato", "elenco numerato" e così via, indipendentemente dai glifi dei marcatori visivi effettivamente disegnati dal renderer PDF

Se un elenco non ha un sistema di numerazione esplicito, ad esempio termini senza punti visivi, usare None o omettere l'attributo.

Esempio

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

Vedere anche

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics