SetStructElemListNumbering

Tagged PDF, Accessibility

Description

Stelt het /ListNumbering-attribuut (List-attribuuteigenaar) in op het structuurelement dat momenteel geopend is op de tag-stack; de waarde declareert de markering of het nummeringsschema dat wordt gebruikt voor items in een L (lijst) structuurelement, waardoor ondersteunende technologie het lijsttype correct kan aankondigen; dit is gelijk aan het aanroepen van AddTagAttribute met Owner=List, Name=ListNumbering en de schemanaam als de waarde

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	Het nummeringsschema voor de lijst. Moet een van de volgende waarden zijn (hoofdlettergevoelig): None — geen zichtbare marker (standaard als attribuut ontbreekt) Disc — gevulde cirkel (•) Circle — open cirkel (○) Square — gevuld vierkant (■) Decimal — 1, 2, 3 … UpperRoman — I, II, III … LowerRoman — i, ii, iii … UpperAlpha — A, B, C … LowerAlpha — a, b, c …

Numbering

Het nummeringsschema voor de lijst. Moet een van de volgende waarden zijn (hoofdlettergevoelig):

None — geen zichtbare marker (standaard als attribuut ontbreekt)
Disc — gevulde cirkel (•)
Circle — open cirkel (○)
Square — gevuld vierkant (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Return value

Retourneert 1 bij succes; retourneert 0 als er geen document open is of als er momenteel geen tag open is op de tag-stack

Remarks

Roep deze functie aan na BeginTag met tagtype L (lijst) en vóór EndTag; het attribuut /ListNumbering is gedefinieerd in ISO 32000-1 §14.8.5.3.2 (List attribute owner, Tabel 336)

Het attribuut is van toepassing op het bevattende L-element, niet op individuele LI-items; stel het eenmalig in op het L-element onmiddellijk na het openen ervan; het attribuut is adviserend: het vertelt ondersteunende technologie wat voor soort lijst dit is, zodat het "bulletlijst", "genummerde lijst", enzovoort kan aankondigen — ongeacht welke visuele markeringssymbolen daadwerkelijk door de PDF-renderer zijn getekend

Wanneer een lijst geen expliciet nummeringssysteem heeft (bijvoorbeeld een reeks termen zonder visuele opsommingstekens), gebruik dan None of laat het attribuut helemaal weg

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