THPDFFDFAnnotationGraph クラス

ユニット：HPDFFDFAnnotations

境界付き FDF 値グラフ、その間接オブジェクト、注釈配列を所有します

読み取りと書き込み

Decode(Bytes, Options, AllowFields) は完全なバイナリ FDF データを検証し、呼び出し側が所有するグラフを返します。Encode は、再生成されたストリーム長とクロスリファレンスオフセット付きの正準 FDF バイトを返します

AnnotationCount、Annotation、AnnotationPage、ObjectCount は許可された注釈グラフを検査します。Resolve はグラフスコープの間接参照をたどります

オプションの AllowFields デコードフラグは、グラフ検査のために Fields 配列を許可します。フィールド充填を実装するものでも、注釈のみのアダプタがフィールド更新を破棄することを認めるものでもありません

構築

THPDFFDFOptions でグラフを作成し、StartAnnotations を呼び出してから、CreateValue、SetScalar、SetStream、AddItem、AddEntry、Define、AppendAnnotation で値を構築します

ビルダーのスカラートークンは PDF 構文を使用します。スラッシュ前置きの名前や括弧で囲まれた文字列などです。ディクショナリエントリ名は先行スラッシュなしのデコード済み名前バイトです

すべての値はそのグラフに属し、コンテナエントリは借用です。子を独立して解放したり、別のグラフの値を接続したり、グラフ解放後に値を保持したりしないでください

構築されたストリームはエンコード時に正準な Length を受け取ります。一致する Length エントリを手動で構築するのではなく、ストリームバイトを供給してください

コンテキストと上限

ActionCount、Action、IsLocalGoTo、IsLocalDestination、LocalDestinationPage は、実際の注釈アクションコンテキストをアクションを実行せずに検査します

グラフの変更はキャッシュされたアクションコンテキストを無効化します。以降の問い合わせは、同じ作業ストレージ、深さ、キャンセル上限のもとで再構築します

ReservedBytes は保守的な許可計上を報告し、Reserve はアダプタが割り当て前にグラフ関連の追加ストレージを許可できるようにします

不正な参照、デコード済みディクショナリ名の重複、無効な注釈ページ、不許可の subtype、上限超過は、エンコード結果が返される前に例外を発生させます

ドキュメントレベルの置換、権限、公開動作については ネイティブ注釈 FDF 交換を参照してください