BeginTagEx

PDF etiquetado, acessibilidade

Descrição

Abre um elemento de estrutura PDF etiquetado na página atual, com um atributo de idioma natural explícito. É idêntico a BeginTag, mas acrescenta um parâmetro Lang que é escrito no atributo /Lang do elemento de estrutura

Utilize esta função para conteúdo cujo idioma difira do idioma predefinido do documento (definido por SetPDFUAMode ou SetDocumentLanguage). A ISO 14289-1 §7.2 exige a definição do atributo /Lang em qualquer segmento de texto que não esteja no idioma principal do documento

As etiquetas têm de estar equilibradas: todas as chamadas de BeginTagEx têm de ser seguidas por uma chamada correspondente de EndTag. As etiquetas podem ser aninhadas

Sintaxe

Delphi

Function TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang);

Parâmetros

TagType	Tipo de estrutura PDF padrão: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (consulte ISO 32000-1 §14.8.4)
AltText	Texto alternativo para imagens e outro conteúdo não textual (atributo `/Alt`). Passe uma cadeia vazia se não for necessário
ActualText	Texto de substituição para conteúdo cuja forma visual difere do significado lógico (atributo `/ActualText`). Passe uma cadeia vazia se não for necessário
Lang	Etiqueta de idioma BCP 47 do conteúdo deste elemento, por exemplo, `en-US`, `fr-FR`, `zh-Hans`. Passe uma cadeia vazia para herdar o idioma do documento. Quando não está vazia, substitui o idioma ao nível do documento para este elemento e todos os respetivos descendentes

Valores devolvidos

0	Falha (nenhum documento aberto)
1	Etiqueta aberta com êxito

Exemplo

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;