SetAutoTagMode

带标签的 PDF

描述

启用普通绘制调用自行携带的结构标记

语法

Delphi

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

参数

Mode	位掩码：`1` 标记文本，`2` 将页面装饰标记为工件，`4` 将图像标记为图形，`8` 标记绘制的表格，`15` 执行全部四项，`0` 将其关闭

返回值

Mode	调用前生效的模式
0	也会在给定负模式时返回，该模式被拒绝且保持不变

备注

启用文本标记时，文本会被标记为段落，紧接在 RegisterHeading 后绘制的文本会被标记为该级别的标题，启用页眉页脚标记时，运行页眉和页脚会被标记为工件，因此阅读器会跳过它们，而非在每页朗读相同的行

启用图形标签后，绘制的图像会成为带有 RegisterFigure 留下描述的图形；若 RegisterDecoration 表示其没有含义，则会在布局工件内绘制

启用表格标记后，DrawTableRows 会将表格、其行和单元格载入结构树。由 SetTableHeaderRowCount 指定的行将成为表头单元格

启用此模式还会将文档标记为带标记文档。在该标记存在前，阅读器会将结构视为不存在，因此没有该标记的带标记文档读取时如同完全没有结构

在使用 BeginTag 打开的标签内，自动标记会暂时停止：当调用方正在描述结构本身时，不会在其打开的内容中嵌套任何元素，它也绝不在工件内标记，因为结构元素会使文件无效，并且不会为读者会宣布为空白的空文本打开元素

该模式属于库实例，而不属于文档

示例

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

另请参阅

GetAutoTagMode、RegisterHeading、BeginTag、BeginArtifact、RegisterFigure、RegisterDecoration、SetTableHeaderRowCount