SetStructElemAltTextA

Tagged PDF & acessibilidade

Descrição

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

Define a entrada /Alt no elemento de estrutura que está a ser criado na pilha de etiquetas. O texto alternativo é a descrição textual que a tecnologia de apoio (leitores de ecrã, linhas braille) apresenta aos utilizadores quando o elemento não pode ser composto visualmente — por exemplo, uma imagem, figura ou fórmula matemática

Esta função equivale a passar um argumento AltText não vazio a BeginTag ou BeginTagEx, mas permite definir ou atualizar o texto alternativo depois de o elemento ter sido aberto. É útil quando a descrição é calculada ou obtida de forma assíncrona depois de o tipo do elemento ser conhecido

Sintaxe

Delphi

Function DLSetStructElemAltTextA(InstanceID: Integer; AltText: PAnsiChar): Integer;

DLL

int DLSetStructElemAltTextA(int InstanceID, const char * AltText);

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, enquanto o elemento de destino estiver no topo da pilha de etiquetas, ou em qualquer momento antes da chamada correspondente de EndTag

AltText e ActualText têm finalidades diferentes. AltText é um substituto textual completo de todo o elemento — substitui o conteúdo visual para os utilizadores que não conseguem percecionar o resultado apresentado. ActualText (ISO 32000-1 §14.9.4) fornece a sequência exata de carateres Unicode para glifos inline cujo texto extraído estaria de outro modo incorreto (como ligaduras) e não substitui a apresentação. Normalmente, os leitores de ecrã verbalizam AltText para elementos Figure e Formula e utilizam ActualText para correções ao nível dos carateres

A norma ISO 32000-1 §14.9.3 define a entrada /Alt. A PDF/UA-1 (ISO 14289-1 §7.5) exige descrições alternativas nos elementos de estrutura Figure e Formula. GetPDFUADiagnostics comunica o código de problema FIGURE-NO-ALT:N quando falta texto Alt a elementos Figure ou Formula

Exemplo

// Tag an embedded chart image with alternative text
PDFlib.BeginTag('Figure', '', '');
PDFlib.SetStructElemAltText('Bar chart: Q1 sales 120, Q2 sales 145, Q3 sales 98');
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

Consulte também

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics