BeginArtifactExA

タグ付き PDF、アクセシビリティ

説明

末尾の A は ANSI（char）DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は BeginArtifactEx と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます

明示的なアーティファクトタイプとオプションの Pagination サブタイプを指定して、PDF アーティファクトのマーク付きコンテンツシーケンスを 1 回の呼び出しで開きます。BeginArtifact を拡張し、ISO 32000-1 §14.8.2.2.1 Table 330 で定義された完全なアーティファクトプロパティ辞書に対応します

1 つの演算子でアーティファクトタイプ（Pagination、Layout、Page）と Pagination サブタイプ（Header、Footer、Watermark、PageNum、LineNum）の両方を表す必要がある場合に、この関数を使用します。一方の次元だけが必要な場合は BeginArtifact で十分です

各 BeginArtifactEx 呼び出しの後には、対応する EndArtifact 呼び出しが必要です

構文

Delphi

Function DLBeginArtifactExA(InstanceID: Integer; ArtifactType, ArtifactSubtype: PAnsiChar): Integer;

DLL

int DLBeginArtifactExA(int InstanceID, const char * ArtifactType, const char * ArtifactSubtype);

パラメータ

ArtifactType/Type プロパティとして書き込むアーティファクト型名。ISO 32000-1 §14.8.2.2.1 による有効な値:
  • Pagination — ページヘッダー、フッター、ページ番号、またはその他のページネーション要素
  • Layout — 列罫線、背景装飾などレイアウト主導のコンテンツ
  • Page — 論理構造に関連しない固有のページコンテンツ
/Type を省略するには空文字列を渡します（演算子は /Subtype のみ、または素の /Artifact BMC にフォールバックします）
ArtifactSubtype/Subtype プロパティとして書き込まれるページネーションサブタイプ。ArtifactType が Pagination の場合にだけ意味を持ちます。一般的な値: Header、Footer、Watermark、PageNum、LineNum。/Subtype を省略するには空文字列を渡します

書き込まれる演算子

Both non-empty/Artifact << /Type /T /Subtype /S >> BMC
Type only/Artifact << /Type /T >> BMC
Subtype only/Artifact << /Subtype /S >> BMC
Both empty/Artifact BMC 演算子

戻り値

0失敗（ドキュメントが開かれていません）
1アーティファクトシーケンスを正常に開きました

例

// Mark a running header as a Pagination artifact with subtype Header
PDF.BeginArtifactEx('Pagination', 'Header');
PDF.PrintText(50, 780, 'Chapter 3  —  Results');
PDF.EndArtifact;

// Mark a column rule as a Layout artifact (no subtype needed)
PDF.BeginArtifactEx('Layout', '');
PDF.DrawLine(300, 50, 300, 750);
PDF.EndArtifact;