SetStructElemListNumbering

Tagged PDF, Accessibility

Description

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

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	O esquema de numeração da lista; deve ser um dos seguintes valores (diferencia maiúsculas de minúsculas): None — sem marcador visível (padrão quando o atributo está ausente) Disc — círculo preenchido (•) Circle — círculo aberto (○) Square — quadrado preenchido (■) Decimal — 1, 2, 3 … UpperRoman — I, II, III … LowerRoman — i, ii, iii … UpperAlpha — A, B, C … LowerAlpha — a, b, c …

Numbering

O esquema de numeração da lista; deve ser um dos seguintes valores (diferencia maiúsculas de minúsculas):

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

Return value

Retorna 1 em caso de sucesso; retorna 0 se nenhum documento estiver aberto ou nenhuma tag estiver aberta no momento na pilha de tags

Remarks

Chame esta função após BeginTag com o tipo de tag L (lista) e antes de EndTag; o atributo /ListNumbering é definido na norma ISO 32000-1 §14.8.5.3.2 (proprietário do atributo Lista, Tabela 336)

O atributo se aplica ao elemento L contêiner, não aos itens LI individuais; defina-o uma vez no elemento L imediatamente após abri-lo; o atributo é informativo: ele informa à tecnologia assistiva que tipo de lista é esta para que ela possa anunciar "lista com marcadores", "lista numerada" e assim por diante — independentemente de quais glifos de marcação visual foram realmente desenhados pelo renderizador PDF

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

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