BeginTagA

PDF etiquetado, acessibilidade

Descrição

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

Abre um elemento de estrutura PDF etiquetado na página atual. Escreve um operador BDC (Begin Marked Content with Dictionary) no fluxo de conteúdo e regista o elemento na árvore de estrutura lógica do documento. A árvore de estrutura é finalizada automaticamente quando o documento é guardado

As etiquetas têm de estar equilibradas: cada chamada BeginTag tem de ser seguida por uma chamada EndTag correspondente. As etiquetas podem ser aninhadas

Sintaxe

Delphi

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

DLL

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

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 (corresponde ao atributo PDF `/Alt`). Passe uma cadeia vazia se não for necessário
ActualText	Texto de substituição para conteúdo cuja representação visual difere do respetivo significado lógico (corresponde ao atributo PDF `/ActualText`). Passe uma cadeia vazia se não for necessário

Valores devolvidos

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

Exemplo

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Observações

Utilize BeginArtifact/EndArtifact para conteúdo decorativo (cabeçalhos, rodapés e elementos de fundo da página) que não deva ser lido por leitores de ecrã

O documento deve estar em modo de escrita (criado ou aberto para alteração). Chame SetPDFUAMode antes de aplicar etiquetas para cumprir os requisitos de PDF/UA-1