BeginTagA
PDF marcado, 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 BeginTag e os argumentos string são interpretados usando a página de código atual de SetAnsiMode
Abre um elemento de estrutura de PDF marcado na página atual. Grava um operator BDC (Begin Marked Content with Dictionary) no content stream e registra o elemento na árvore de estruturas lógica do documento. A árvore de estruturas é finalizada automaticamente quando o documento é salvo.
As tags devem ser balanceadas: toda chamada a BeginTag deve ser seguida por uma chamada correspondente a EndTag. Tags 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 | 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 (corresponde ao atributo /Alt do PDF). Passe uma string vazia se não for necessário. |
| ActualText | Texto de substituição para conteúdo cuja representação visual difere do significado lógico (corresponde ao atributo /ActualText do PDF). Passe uma string vazia se não for necessário. |
Valores retornados
| 0 | Failed (no document is open) |
|---|---|
| 1 | Tag opened successfully |
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
Use BeginArtifact/EndArtifact para conteúdo decorativo (cabeçalhos e rodapés de página, elementos de fundo) que não deve ser lido por screen readers.
O documento deve estar em modo de escrita (criado ou aberto para modificação). Chame SetPDFUAMode antes do tagging para atender aos requisitos do PDF/UA-1.