SetAutoTagMode
PDF marcado
Descrição
Turns on structure tagging that ordinary drawing calls carry by themselves.
Sintaxe
Delphi
Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;Parâmetros
| Mode | Uma máscara de bits: 1 marca o texto com tags, 2 marca mobiliário da página como artifacts, 4 marca imagens como figures, 8 marca tabelas desenhadas, 15 faz tudo isso e 0 desliga. |
|---|
Valores retornados
| Mode | O modo vigente antes desta chamada. |
|---|---|
| 0 | Também retornado quando é dado um modo negativo, que é recusado e deixa o modo inalterado. |
Observações
Com o tagging de texto ligado, o texto é marcado como parágrafo, e texto desenhado logo depois de RegisterHeading é marcado como título daquele nível. Com a marcação de mobiliário ligada, cabeçalhos e rodapés corridos são marcados como artifacts, para que o reader os pule em vez de anunciar a mesma linha em toda página.
Com o tagging de figures ligado, uma imagem desenhada vira uma figure que carrega a descrição deixada por RegisterFigure, ou é desenhada dentro de um artifact de layout quando RegisterDecoration disse que ela não carrega significado.
Com o tagging de tabelas ligado, DrawTableRows leva a tabela, as linhas e as células dela para a árvore de estruturas. As linhas nomeadas por SetTableHeaderRowCount viram células de cabeçalho.
Ativar o modo também marca o documento como tagged Um leitor trata a estrutura como ausente até que essa marca exista, de modo que um documento tagged sem ela é lido como se não tivesse estrutura alguma
O tagging automático fica de lado dentro de uma tag aberta com BeginTag: enquanto o chamador está descrevendo a própria estrutura, nada é aninhado dentro do que ele abriu. Também nunca marca conteúdo dentro de um artifact, onde um elemento de estrutura deixaria o arquivo inválido, e nunca abre um elemento para texto vazio, que um reader anunciaria como um branco.
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 artifactVeja também
GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount