SetStructElemListNumberingA

PDF marcado, Acessibilidade

Descrição

O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de SetStructElemListNumbering e os argumentos de string são interpretados usando a página de código atual definida por SetAnsiMode

Define o atributo /ListNumbering (owner de atributos List) no elemento de estrutura aberto no topo da pilha de tags. O valor declara o marcador ou o esquema de numeração usado nos itens de um elemento de estrutura L (list), permitindo que tecnologia assistiva 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 DLSetStructElemListNumberingA(InstanceID: Integer; Numbering: PAnsiChar): Integer;

DLL

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

Parâmetros

NumberingThe list numbering scheme. Must be one of the following values (case-sensitive):

None — no visible marker (default when attribute is absent)
Disc — filled circle (•)
Circle — open circle (○)
Square — filled square (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Valor de retorno

Retorna 1 em caso de sucesso. Retorna 0 se nenhum documento estiver aberto ou nenhuma tag estiver aberta na pilha de tags

Observações

Chame esta função depois de BeginTag com tipo de tag L (list) e antes de EndTag. O atributo /ListNumbering é definido na ISO 32000-1 §14.8.5.3.2 (List attribute owner, Tabela 336).

O atributo vale para o elemento L que o contém, não para itens LI individuais. Defina-o uma única vez no elemento L, imediatamente após abri-lo. O atributo é informativo: diz à tecnologia assistiva que tipo de lista é essa, para que ela anuncie "lista com marcadores", "lista numerada" e assim por diante — independentemente dos glifos de marcador visual realmente desenhados pelo renderizador de PDF.

Quando uma lista não tem sistema de numeração explícito (por exemplo, uma série de termos sem marcadores visuais), use None ou omita o atributo por completo.

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

Veja também

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics