AddAnnotationState

注釈とホットスポットリンク

説明

このページでは、「注釈とホットスポットリンク」トピックの PDFlibPas の AddAnnotationState について説明します。API 名、パラメーター、クラス名、ファイル名、およびリテラルは、Delphi ライブラリおよび DLL エントリポイントに表示されるとおりに正確に保持されます。

AddAnnotationState は、選択されたページ上の既存の注釈に対するレビューステータスの変更を記録します（ISO 32000-1 §12.5.6.3）。これは、/IRT エントリがターゲット注釈を参照し、/State および /StateModel エントリがレビューステータスを保持する、非表示のテキスト注釈を追加します。これは、Acrobat のコメントパネルで使用されるレビューワークフローと一致します。

構文

Delphi

Function TPDFlib.AddAnnotationState(TargetAnnot: Integer; Const Author: WideString; State, StateModel: Integer): Integer;

パラメーター

TargetAnnot は、ステータスを設定する選択されたページ上の注釈の 1 から始まるインデックスです。Author は、/T エントリに保存されるレビュー担当者名です。StateModel は、ステートモデルを選択します。0 = Review、1 = Marked です。State は、モデル内のステートを選択します。Review モデルの場合、0 = None、1 = Accepted、2 = Rejected、3 = Cancelled、4 = Completed となります。Marked モデルの場合、0 = Unmarked、1 = Marked となります。

戻り値

ページの注釈リストに新しく追加されたステート注釈の 1 から始まるインデックスを返します。ステートまたはモデルのセレクターが不明な場合、TargetAnnot が存在しない場合、またはターゲット注釈が間接オブジェクトとして保存されていない場合は 0 を返します。

備考

ステート注釈は Hidden フラグが設定された状態で書き込まれるため、ページ上にはレンダリングされません。代わりに、レビュー機能をサポートする PDF ビューアではコメントパネルに表示されます。記録されたステータスを読み取るには、GetAnnotState および GetAnnotStateModel を使用します。PDF 1.5 が必要です。必要に応じて、ドキュメントのバージョンは自動的に引き上げられます。