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