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

ModeUma 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

ModeO modo vigente antes desta chamada.
0També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 artifact

Veja também

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