SetAutoTagMode

PDF etiquetado

Descrição

Ativa a etiquetagem de estrutura que as chamadas de desenho normais transportam por si próprias

Sintaxe

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Parâmetros

Mode	Uma máscara de bits: `1` etiqueta texto, `2` assinala elementos decorativos da página como artefactos, `4` etiqueta imagens como figuras, `8` etiqueta tabelas desenhadas, `15` executa as quatro operações e `0` desativa-as

Valores devolvidos

Mode	O modo em vigor antes desta chamada
0	Também é devolvido quando é fornecido um modo negativo, que é recusado e mantém o modo inalterado

Observações

Com a etiquetagem de texto ativada, o texto é etiquetado como parágrafo e o texto desenhado imediatamente após RegisterHeading é etiquetado como cabeçalho desse nível. Com a marcação de elementos acessórios ativada, os cabeçalhos e rodapés corridos são marcados como artefactos, para que um leitor os ignore em vez de anunciar a mesma linha em todas as páginas

Com a etiquetagem de figuras ativada, uma imagem desenhada torna-se uma figura que contém a descrição deixada por RegisterFigure, ou é desenhada dentro de um artefacto de disposição quando RegisterDecoration indicou que não tinha significado

Com a etiquetagem de tabelas ativada, DrawTableRows transporta a tabela, as respetivas linhas e células para a árvore de estrutura. As linhas indicadas por SetTableHeaderRowCount tornam-se células de cabeçalho

Ativar o modo também marca o documento como etiquetado. Um leitor considera a estrutura ausente até essa marca estar presente, pelo que um documento etiquetado sem ela é lido como se não tivesse qualquer estrutura

A etiquetagem automática não interfere dentro de uma etiqueta aberta com BeginTag: enquanto o chamador descreve a própria estrutura, nada é aninhado no que abriu. Também nunca aplica etiquetas dentro de um artefacto, onde um elemento de estrutura tornaria o ficheiro inválido, nem abre um elemento para texto vazio, que seria anunciado como um espaço em branco por um leitor

O modo pertence à instância da biblioteca, não a um documento

Exemplo

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

Consulte também

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount