SetStructElemActualText

Tagged PDF & acessibilidade

Descrição

Define a entrada /ActualText no elemento de estrutura atualmente em construção na pilha de etiquetas. ActualText fornece o texto Unicode exato que o elemento representa, substituindo qualquer texto extraído do fluxo de conteúdo PDF pelo software de leitura

Utilize esta função quando os glifos compostos no fluxo de conteúdo não correspondam diretamente aos carateres pretendidos na ordem de leitura — por exemplo, um glifo de ligadura (ff, fi, fl) que deve ser lido como a sequência de dois carateres ff, fi ou fl. Sem ActualText, as ferramentas de extração de texto e os leitores de ecrã podem produzir resultados incorretos para esses glifos

Sintaxe

Delphi

Function TPDFlib.SetStructElemActualText(Const ActualText: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemActualText(ActualText As String) As Long

DLL

int DLSetStructElemActualText(int InstanceID, const wchar_t * ActualText);

Parâmetros

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 ou BeginTagEx, enquanto o elemento de destino está no topo da pilha de etiquetas

ActualText e AltText têm finalidades diferentes. AltText (definido através do parâmetro AltText de BeginTag) é uma representação alternativa de todo o elemento, destinada a tecnologia de apoio quando não é possível apresentar o conteúdo visual. ActualText complementa a extração de texto dos fluxos de conteúdo: substitui a sequência de carateres extraída do elemento, mas não impede o processamento. Os leitores de ecrã compatíveis com ambos utilizam normalmente ActualText na leitura em voz alta quando está presente

A norma ISO 32000-1 §14.9.4 define ActualText como uma entrada de cadeia de texto PDF no dicionário do elemento de estrutura. A PDF/UA-1 (ISO 14289-1 §7.1) exige que o conteúdo textual seja extraível e correto; ActualText é o mecanismo normalizado para cumprir este 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;

Consulte também

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics