SetStructElemListNumberingA

PDF balisé, accessibilité

Description

Le A final indique le point d’entrée ANSI (char) de la DLL ; la surface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à celui de SetStructElemListNumbering et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Définit /ListNumbering (propriétaire List) sur l’élément ouvert. La valeur déclare le marqueur ou schéma de numérotation des éléments d’un L, permettant aux technologies d’assistance d’annoncer le type. Équivaut à AddTagAttribute avec Owner=List, Name=ListNumbering et le nom du schéma

Syntaxe

Delphi

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

DLL

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

Paramètres

Numbering	Schéma de numérotation de liste, sensible à la casse : None — aucun marqueur visible Disc — cercle plein (•) Circle — cercle vide (○) Square — carré plein (■) Decimal — 1, 2, 3 … UpperRoman — I, II, III … LowerRoman — i, ii, iii … UpperAlpha — A, B, C … LowerAlpha — a, b, c …

Valeur de retour

Renvoie 1 en cas de réussite Renvoie 0 si aucun document n'est ouvert ou si aucune balise n'est actuellement ouverte sur la pile de balises

Remarques

Appelez cette fonction après BeginTag avec le type de balise L (liste) et avant EndTag. L’attribut /ListNumbering est défini dans ISO 32000-1 §14.8.5.3.2 (propriétaire d’attribut List, tableau 336)

L’attribut s’applique à l’élément L conteneur, pas aux éléments LI. Définissez-le une fois sur L immédiatement après son ouverture. Il est indicatif et informe les technologies d’assistance du type de liste, afin qu’elles annoncent « liste à puces », « liste numérotée », etc., indépendamment des glyphes visuels tracés

Lorsqu'une liste n'a pas de système de numérotation explicite, par exemple une série de termes sans puces visibles, utilisez None ou omettez entièrement l'attribut

Exemple

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

Voir aussi

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics