SetStructElemActualTextA

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

Define a entrada /ActualText no elemento de estrutura em construção no momento na pilha de tags. ActualText fornece o texto Unicode exato que o elemento representa, sobrepondo qualquer texto extraído do content stream do PDF pelo software leitor

Use this function when the glyphs rendered in the content stream do not directly map to their intended reading-order characters — for example, a ligature glyph (ﬀ, ﬁ, ﬂ) that should read as the two-character sequence ff, fi, or fl. Without ActualText, text-extraction tools and screen readers may produce incorrect output for such glyphs.

Sintaxe

Delphi

Function DLSetStructElemActualTextA(InstanceID: Integer; ActualText: PAnsiChar): Integer;

DLL

int DLSetStructElemActualTextA(int InstanceID, const char * ActualText);

Parâmetros

ActualText	A string de texto Unicode a associar ao 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 ou BeginTagEx, enquanto o elemento alvo está no topo da pilha de tags.

ActualText e AltText têm propósitos diferentes. AltText (definido pelo parâmetro AltText de BeginTag) é uma representação alternativa do elemento inteiro, destinada a tecnologia assistiva quando o conteúdo visual não pode ser renderizado. ActualText complementa a extração de texto do content stream: substitui a sequência de caracteres extraída do elemento, mas não suprime a renderização. Screen readers que suportam ambos normalmente usam ActualText na leitura em voz alta, quando presente.

A ISO 32000-1 §14.9.4 define ActualText como uma entrada de text string do PDF no dicionário do elemento de estrutura. O PDF/UA-1 (ISO 14289-1 §7.1) exige que o conteúdo de texto seja extraível e correto; ActualText é o mecanismo padrão para satisfazer esse requisito em sequências de glifos cuja extração direta seria ambígua ou incorreta.

Exemplo

// Tag a ligature glyph so that text extraction yields "fi"
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemActualText('fi');
PDFlib.TextOut(x, y, #$FB01);   // U+FB01 LATIN SMALL LIGATURE FI
PDFlib.EndTag;

Veja também

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics