AddAnnotationState

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

説明

このページでは、PDF Library for Delphi の「注釈とホットスポットリンク」トピックに属する 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 が必要で、必要に応じて文書バージョンが自動的に引き上げられます