SetStructElemListNumbering

PDF etiquetado, acessibilidade

Descrição

Define o atributo /ListNumbering (proprietário de atributos List) no elemento de estrutura atualmente aberto na pilha de etiquetas. O valor declara o esquema de marcador ou numeração utilizado para os itens de um elemento de estrutura L (lista), permitindo que a tecnologia de apoio anuncie corretamente o tipo de lista. Equivale a chamar AddTagAttribute com Owner=List, Name=ListNumbering e o nome do esquema como valor

Sintaxe

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

Parâmetros

NumberingO esquema de numeração da lista. Tem de ser um dos seguintes valores (sensíveis a maiúsculas e minúsculas):

None — sem marca visível (predefinição quando o atributo está ausente)
Disc — círculo preenchido (•)
Circle — círculo vazio (○)
Square — quadrado preenchido (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Valor devolvido

Devolve 1 em caso de êxito. Devolve 0 se não houver nenhum documento aberto ou nenhuma etiqueta atualmente aberta na pilha de etiquetas

Observações

Chame esta função depois de BeginTag com o tipo de etiqueta L (lista) e antes de EndTag. O atributo /ListNumbering está definido na ISO 32000-1 §14.8.5.3.2 (proprietário de atributos List, Tabela 336)

O atributo aplica-se ao elemento L contentor, não aos itens LI individuais. Defina-o uma vez no elemento L imediatamente depois de o abrir. O atributo é consultivo: indica às tecnologias de apoio o tipo de lista para que possam anunciar "lista com marcas", "lista numerada" e assim por diante — independentemente dos glifos de marcação visual efetivamente desenhados pelo compositor de PDF

Quando uma lista não tiver um sistema de numeração explícito (por exemplo, uma série de termos sem marcas visuais), utilize None ou omita totalmente o atributo

Exemplo

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

Consulte também

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics