BeginArtifact
標籤式 PDF、協助工具
描述
開啟 PDF 工件區域。工件內容屬於裝飾性或結構性（頁首、頁尾、頁碼、背景影像、分隔線），並明確排除在文件的邏輯閱讀順序之外。螢幕助讀程式會完全略過工件區域在
BeginArtifact 與對應的 EndArtifact 呼叫之間寫入工件的圖形或文字
語法
Delphi
Function TPDFlib.BeginArtifact(Const SubType: WideString): Integer;ActiveX
Function PDFlib::BeginArtifact(SubType As String) As LongDLL
int DLBeginArtifact(int InstanceID, const wchar_t * SubType);參數
| SubType | 傳入 Pagination、Layout、Page 或 PDF 2.0 的 Background 以寫入工件 /Type；傳入 Header、Footer、Watermark、PageNum、LineNum、Redaction 或 Bates 以寫入 Pagination /Subtype；傳入空字串則產生單純的 /Artifact BMC |
|---|
寫入的運算子
非空值使用屬性字典加上 BDC；空值使用 /Artifact BMC
PDF 版本
Background、PageNum、LineNum、Redaction 與 Bates 需要 PDF 2.0，並會自動提高輸出功能版本
傳回值
| 0 | 失敗（沒有已開啟的文件） |
|---|---|
| 1 | 工件區域已成功開啟 |
範例
// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;