SetStructElemListNumbering

Tagged PDF, Accessibility

Description

Imposta l'attributo /ListNumbering (proprietario dell'attributo List) sull'elemento di struttura attualmente aperto sullo stack dei tag; il valore dichiara lo schema di marcatore o numerazione utilizzato per gli elementi in un elemento di struttura L (elenco), consentendo alle tecnologie assistive di annunciare correttamente il tipo di elenco; equivalente a chiamare AddTagAttribute con Owner=List, Name=ListNumbering e il nome dello schema come valore

Syntax

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

Parameters

Numbering	Lo schema di numerazione dell'elenco; deve essere uno dei seguenti valori (case-sensitive): None — nessun indicatore 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 …

Numbering

Lo schema di numerazione dell'elenco; deve essere uno dei seguenti valori (case-sensitive):

None — nessun indicatore 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 …

Return value

Restituisce 1 in caso di successo; restituisce 0 se nessun documento è aperto o se nessun tag è attualmente aperto sullo stack dei tag

Remarks

Chiamare questa funzione dopo BeginTag con tipo tag L (elenco) e prima di EndTag; l'attributo /ListNumbering è definito in ISO 32000-1 §14.8.5.3.2 (List attribute owner, Table 336)

L'attributo si applica all'elemento L contenitore, non ai singoli elementi LI; impostarlo una volta sull'elemento L subito dopo averlo aperto; l'attributo è consultivo: indica alle tecnologie assistive di che tipo di elenco si tratta, in modo che possano annunciare "elenco puntato", "elenco numerato" e così via — indipendentemente dai glifi dei marcatori visivi effettivamente disegnati dal renderer PDF

Quando un elenco non ha un sistema di numerazione esplicito (ad esempio, una serie di termini senza punti elenco visivi), usare None o omettere completamente l'attributo

Example

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