BeginTag

PDF etiquetado, acessibilidade

Descrição

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 TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

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

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * 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

Etiquetar um documento marca-o como etiquetado ao ser guardado, condição necessária para que um leitor sequer considere presente a estrutura. Uma definição de SetMarkInfo efetuada pelo chamador é mantida