BeginTagExA

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

Abre um elemento de estrutura de PDF marcado na página atual, com um atributo de idioma natural explícito. Idêntico a BeginTag, mas adiciona o parâmetro Lang, gravado no atributo /Lang do elemento de estrutura.

Use esta função para conteúdo cujo idioma difere do idioma padrão do documento (definido por SetPDFUAMode ou SetDocumentLanguage). A ISO 14289-1 §7.2 exige que o atributo /Lang seja definido em todo segmento de texto que não esteja no idioma principal do documento.

As tags devem ser balanceadas: toda chamada a BeginTagEx deve ser seguida por uma chamada correspondente a EndTag. Tags podem ser aninhadas.

Sintaxe

Delphi

Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;

DLL

int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);

Parâmetros

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Texto alternativo para imagens e outros conteúdos não textuais (atributo `/Alt`). Passe uma string 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 string vazia se não for necessário.
Lang	Tag de idioma BCP 47 para o conteúdo deste elemento, ex.: `en-US`, `fr-FR`, `zh-Hans`. Passe uma string vazia para herdar o idioma do documento. Quando não vazia, sobrepõe o idioma do documento para este elemento e todos os seus descendentes.

Valores retornados

0	Failed (no document is open)
1	Tag opened successfully

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;