SetStructElemExpansionA

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 SetStructElemExpansion e os argumentos de cadeia são interpretados através da página de códigos atual de SetAnsiMode

Define a entrada /E (texto de expansão) no elemento de estrutura atualmente em construção na pilha de etiquetas. O texto de expansão é a forma escrita por extenso de uma abreviatura ou sigla contida no elemento — por exemplo, World Wide Web para um elemento Span cujo conteúdo seja WWW, ou International Organization for Standardization para um Span que contenha ISO

Os leitores de ecrã e outras tecnologias de apoio pronunciam o texto expandido em vez de tentarem pronunciar os carateres abreviados, o que é essencial para abreviaturas que não podem ser lidas como palavras

Sintaxe

Delphi

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

DLL

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

Parâmetros

Expansion	O texto totalmente expandido da abreviatura ou sigla no elemento de estrutura atual. 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

Chame esta função imediatamente após BeginTag, enquanto o elemento de destino estiver no topo da pilha de etiquetas, ou em qualquer momento antes da chamada correspondente de EndTag

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

/E (Expansion) — A forma por extenso de uma abreviatura ou acrónimo. Utilizada para a pronúncia por leitores de ecrã de conteúdo inline abreviado
/Alt (consulte SetStructElemAltText) — Uma descrição substituta completa para elementos que não podem ser compostos visualmente (imagens, figuras e fórmulas)
/ActualText (consulte SetStructElemActualText) — Uma substituição Unicode exata para sequências de glifos cujo texto extraído estaria, de outro modo, incorreto (ligações tipográficas, variantes de glifos)

A PDF/UA-1 (ISO 14289-1 §7.2) exige que o idioma natural de cada fragmento de texto possa ser determinado sem ambiguidade. Nas abreviaturas e siglas cuja forma abreviada não pode ser pronunciada como uma palavra, /E é o mecanismo normalizado para fornecer essa informação

Aplique /E ao elemento mais interior que envolve a abreviatura — geralmente um elemento Span. A expansão aplica-se apenas ao conteúdo desse elemento e não é herdada pelos elementos subordinados

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;

Consulte também

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics