SetStructElemTitleA

Tagged PDF & acessibilidade

Descrição

O A final indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico a SetStructElemTitle e os argumentos de cadeia são interpretados através da página de códigos atual de SetAnsiMode

Define a entrada /T (título) no elemento de estrutura que está a ser construído na pilha de etiquetas. O título é uma legenda legível que caracteriza o elemento específico — por exemplo, Capítulo 1, Tabela de resumo ou Figura 3: Vendas trimestrais — em vez de se limitar a repetir o tipo de elemento

Sintaxe

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

Parâmetros

Title	Uma cadeia de texto legível que identifica esta instância específica do elemento. Passe uma cadeia vazia para limpar um valor definido anteriormente

Valor devolvido

Devolve 1 em caso de êxito ou 0 se nenhum elemento de estrutura estiver atualmente aberto ou nenhum documento estiver selecionado

Observações

A entrada /T é definida na Tabela 324 da ISO 32000-1 §14.7.2. É escrita como uma cadeia de texto PDF no dicionário do elemento de estrutura

Title tem uma finalidade distinta das outras propriedades de texto dum elemento de estrutura:

/T (Title) — Uma etiqueta descritiva do elemento utilizada nos painéis de navegação e etiquetagem. Adequada para cabeçalhos de secções, legendas de tabelas e legendas de figuras
/Alt (consulte SetStructElemAltText) — Um substituto textual completo do elemento para tecnologia de apoio quando não for possível apresentar o elemento
/ActualText (consulte SetStructElemActualText) — uma substituição Unicode exata para sequências de glifos cujo texto extraído estaria incorreto

Os visualizadores de PDF utilizam /T para etiquetar elementos no painel de navegação Tags. As ferramentas de acessibilidade e o software de correção utilizam-no como título de referência para a navegação no documento. Nos elementos de cabeçalho (H1–H6), o próprio conteúdo do elemento funciona como texto do cabeçalho; /T é mais útil para elementos sem texto (Table, Figure, Form) ou contentores (Sect, Div) que necessitem de uma etiqueta descritiva

Exemplo

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

Consulte também

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics