BeginArtifactA
标记 PDF、可访问性
描述
末尾的 A 表示 ANSI(char)DLL 入口点;ActiveX/COM 接口仅公开 Unicode 形式。行为与 BeginArtifact 相同,字符串参数使用当前 SetAnsiMode 代码页解释
打开 PDF 工件区域。工件内容具有装饰性或结构性(页眉、页脚、页码、背景图像、标尺线),并明确排除在逻辑文档阅读顺序之外。屏幕阅读器会完全跳过工件区域
在 BeginArtifact 与匹配的 EndArtifact 调用之间写入伪影的图形或文本
语法
Delphi
Function DLBeginArtifactA(InstanceID: Integer; SubType: PAnsiChar): Integer;
DLL
int DLBeginArtifactA(int InstanceID, const char * SubType);
参数
| SubType | 可选工件子类型名称。常用值:Header、Footer、Watermark、Background。传递空字符串可省略子类型 |
|---|
返回值
| 0 | 失败(未打开文档) |
|---|---|
| 1 | Artifact 区域已成功打开 |
示例
// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;