SetStructElemExpansionA

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 SetStructElemExpansion e os argumentos de string são interpretados usando a página de código atual definida por SetAnsiMode

Define a entrada /E (texto de expansão) no elemento de estrutura sendo construído no topo da pilha de tags. O texto de expansão é a forma por extenso de uma abreviatura ou sigla contida no elemento — por exemplo World Wide Web para um elemento Span cujo conteúdo é WWW, ou International Organization for Standardization para um Span contendo ISO.

Leitores de tela e outras tecnologias assistivas falam o texto de expansão em vez de tentar pronunciar os caracteres abreviados, o que é essencial para abreviações que não podem ser soletradas como palavras

Sintaxe

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

Parâmetros

Expansion	O texto completo por extenso da abreviação ou sigla no elemento de estrutura atual. Passe uma string vazia para limpar um valor definido anteriormente.

Valor de retorno

Retorna 1 em caso de sucesso, 0 se nenhum elemento de estrutura estiver aberto ou nenhum documento estiver selecionado

Observações

Chame esta função imediatamente após BeginTag, enquanto o elemento alvo está no topo da pilha de tags, ou a qualquer momento antes da chamada correspondente de EndTag.

A entrada /E é definida na ISO 32000-1 §14.9.5. É gravada como uma text string do PDF no dicionário do elemento de estrutura e é distinta das demais propriedades de texto:

/E (Expansion) — A forma por extenso de uma abreviatura ou sigla. Usada para a pronúncia por screen readers de conteúdo inline abreviado.
/Alt (see SetStructElemAltText) — A complete substitute description for elements that cannot be rendered visually (images, figures, formulas).
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would otherwise be incorrect (ligatures, glyph variants).

O PDF/UA-1 (ISO 14289-1 §7.2) exige que o idioma natural de cada trecho de texto possa ser determinado sem ambiguidade. Para abreviaturas e siglas cuja forma abreviada não pode ser lida em voz alta como uma palavra, /E é o mecanismo padrão para fornecer essa informação.

Aplique /E no elemento mais interno que envolve a abreviatura — tipicamente um elemento Span. A expansão vale apenas para o conteúdo desse elemento e não é herdada pelos filhos.

Exemplo

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

Veja também

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics