BeginArtifactA
標籤式 PDF、無障礙
描述
結尾的 A 表示 ANSI（char）DLL 進入點；ActiveX/COM 介面只提供 Unicode 形式。行為與 BeginArtifact 完全相同，字串參數依目前 SetAnsiMode 的字碼頁解讀
開啟 PDF artifact 區域。artifact 內容屬裝飾性或結構性（頁首、頁尾、頁碼、背景影像、分隔線），明確排除在文件的邏輯閱讀順序之外。螢幕閱讀器會完全跳過 artifact 區域
artifact 的圖形或文字要寫在 BeginArtifact 與對應的 EndArtifact 呼叫之間。
語法
Delphi
Function DLBeginArtifactA(InstanceID: Integer; SubType: PAnsiChar): Integer;DLL
int DLBeginArtifactA(int InstanceID, const char * SubType);參數
| SubType | 選配的 artifact 子類型名稱。常見值：Header、Footer、Watermark、Background。傳入空字串可省略子類型。 |
|---|
傳回值
| 0 | 失敗（沒有開啟的文件） |
|---|---|
| 1 | Artifact region opened successfully |
範例
// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;