SetMarkInfo
ドキュメントプロパティ、アクセシビリティ
説明
Catalog に文書の /MarkInfo 辞書を設定します。Marked が 1 の場合、Catalog に /MarkInfo << /Marked true /Suspects false >> エントリが追加され、文書が tagged PDF と宣言されます。Marked が 0 の場合、/MarkInfo エントリは削除されます
この関数は SetPDFUAMode および SetPDFAMode により、a 準拠レベル(PDF/A-1a、PDF/A-2a、PDF/A-3a)で自動的に呼び出されます。PDF/UA-1 または PDF/A-A の完全な設定を行わず、タグ付き PDF 状態だけが必要な場合に直接呼び出します
構文
Delphi
Function TPDFlib.SetMarkInfo(Marked: Integer): Integer;
ActiveX
Function PDFlib::SetMarkInfo(Marked As Long) As Long
DLL
int DLSetMarkInfo(int InstanceID, int Marked);
パラメータ
| Marked | 文書をタグ付きとして宣言するには 1(/Marked true と /Suspects false を書き込み)、/MarkInfo エントリを削除するには 0 |
|---|
戻り値
| 1 | /MarkInfo エントリが正常に更新されました |
|---|
備考
ISO 14289-1 (PDF/UA-1) §7.18.6 では、/Suspects を存在させ、false に設定することが求められる(/Marked が true の場合)。ライブラリは常に /Suspects false を /Marked true とともに書き込むため、SetMarkInfo(1) を1回呼び出すだけで両方の要件を満たす
/Marked true の設定は宣言的な記述にすぎず、それ自体でドキュメントの構造ツリーを設定することは ありません。SetMarkInfo(1) の呼び出し後、BeginTag/EndTag の組で構造ツリーを構築し、装飾コンテンツには BeginArtifact/EndArtifact でマークします。保存前に一般的な欠落を表示するには GetPDFUADiagnostics を使用します
読み込み済みドキュメントの /MarkInfo の以前の状態は、IsTaggedPDF で照会できます
例
// Convert a non-tagged loaded document into a tagged one, then add structure
PDF.LoadFromFile('source.pdf', '');
if PDF.IsTaggedPDF = 0 then
begin
PDF.SetMarkInfo(1);
// Re-open page 1 for editing
PDF.SelectPage(1);
PDF.BeginPageUpdate;
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Document Title');
PDF.EndTag;
PDF.EndPageUpdate;
end;
PDF.SaveToFile('tagged.pdf');関連項目
IsTaggedPDF、SetPDFUAMode、SetPDFAMode、BeginTag、GetPDFUADiagnostics