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失败(未打开文档)
1Artifact 区域已成功打开

示例

// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;