SetStructElemListNumberingA

PDF etiquetado, Accesibilidad

Descripción

El sufijo A indica el punto de entrada ANSI (char) de la DLL; la superficie ActiveX/COM expone únicamente la forma Unicode. El comportamiento es idéntico a SetStructElemListNumbering y los argumentos de cadena se interpretan utilizando la página de códigos SetAnsiMode actual

Establece el atributo /ListNumbering (propietario del atributo List) en el elemento de estructura abierto actualmente en la pila de etiquetas. El valor declara el marcador o esquema de numeración utilizado para los elementos de un elemento de estructura L (lista), lo que permite a las tecnologías de asistencia anunciar correctamente el tipo de lista. Equivale a llamar a AddTagAttribute con Owner=List, Name=ListNumbering y el nombre del esquema como valor

Sintaxis

Delphi

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

DLL

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

Parámetros

NumberingEl esquema de numeración de listas. Debe ser uno de los siguientes valores (distingue entre mayúsculas y minúsculas):

None — sin marcador visible (valor predeterminado cuando no existe el atributo)
Disc — círculo relleno (•)
Circle — círculo vacío (○)
Square — cuadrado relleno (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Valor devuelto

Devuelve 1 si se ejecuta correctamente. Devuelve 0 si no hay ningún documento abierto o ninguna etiqueta abierta en la pila de etiquetas

Observaciones

Llame a esta función después de BeginTag con el tipo de etiqueta L (lista) y antes de EndTag. El atributo /ListNumbering se define en ISO 32000-1 §14.8.5.3.2 (propietario de atributo List, Table 336)

El atributo se aplica al elemento L contenedor, no a los elementos LI individuales. Establézcalo una vez en el elemento L inmediatamente después de abrirlo. El atributo es informativo: indica a las tecnologías de asistencia qué tipo de lista es para que puedan anunciar "lista con viñetas", "lista numerada" y similares — con independencia de los glifos de marcador visual que haya dibujado realmente el renderizador PDF

Cuando una lista no tiene un sistema de numeración explícito (por ejemplo, una serie de términos sin viñetas visibles), utilice None u omita por completo el atributo

Ejemplo

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

Véase también

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics