THPDFHeadlessRenderAccess
HPDFHeadlessRenderAccess のレコードは、現在のドキュメントグラフへの逐次読み取り専用アクセスのために THPDFHeadlessDocument.GetRenderAccess(PageIndex) が返すものです
所有側のドキュメントは、使用中ずっと読み込まれたまま変更されない状態でなければなりません。ポインター、リソースディクショナリー、コールバック結果は借用であり、呼び出し側は解放したり変更したりしてはなりません
| フィールド | 契約 |
|---|---|
Context | すべてのコールバックにそのまま渡される不透明なドキュメントポインターです |
PageDictionary, PageResources | 解決済みページディクショナリーと継承リソースディクショナリーです |
Resolve: THPDFHeadlessRenderResolve | 既存の xref、オブジェクトストリーム、セキュリティの各経路で借用オブジェクトを解決します |
ReadStream: THPDFHeadlessRenderReadStream | デコード前に指定された最大値を適用した上で、ドキュメント予算を上限としてデコード済みバイトを返します |
ReadImageBytes: THPDFHeadlessRenderReadImage | 画像ストリームを認証して復号し、有界な接頭フィルターをデコードした上で、デコード済みサンプルか、最終的な JPEG・JPEG 2000・CCITT・JBIG2 のペイロードを、その終端フィルター名と借用 DecodeParms ディクショナリーとともに返します |
FontResolver: THPDFHeadlessRenderFontResolver | 既存のリソースフォントデコーダーへのインターフェースを生成します |
RequireExtractionPermission: THPDFHeadlessRenderPermission | キャンセルと認証済み抽出権限を確認します |
RequireOutputPath: THPDFHeadlessRenderOutputPath | キャンセルを確認し、正規パスと物理ファイル同一性によってソースエイリアスを、ファイルを生成せずに拒否します |
CancellationToken | 呼び出し側所有のドキュメントキャンセルトークンの借用です |
MaxDecodedBytes, MaxDepth | ドキュメントオプションから継承された上限です |
CatalogDictionary: THPDFDictionaryObject は、オプショナルコンテンツ設定のために解決済みカタログを貸します。nil はカタログが供給されなかったことを意味し、オプショナルコンテンツ構造は可視性に影響しません
ResolveOptional: THPDFHeadlessRenderResolve はオプショナルグループのメンバーシップを解決し、欠落・削除済み・世代が古い参照には nil を返します。有効な生存オブジェクトは通常の解析、オブジェクトストリーム、セキュリティ、キャンセル、深さの各チェックを保ち、エラーは伝播します
手動で組み立てたアクセスレコードは、コールバックを割り当てる前に Default(THPDFHeadlessRenderAccess) で初期化してください。nil の ResolveOptional は通常のリゾルバーを使い、nil カタログはオプショナルコンテンツ設定なしのレンダリングを保ちます
出力レンダラーは、ファイル生成の前に RequireOutputPath(Context, FileName) を呼び、独自のステージング、公開、宛先予算ポリシーを適用しなければなりません
Lifetime: IHPDFHeadlessRenderLifetime は グラフ寿命リースを保持します。nil は静的レンダリングでは有効なままですが、明示的なビューアー状態は有効なリースを要求し、期限切れのアクセスをコールバック呼び出しの前に拒否します
ビューは、所有側ドキュメントがクローズ、再読み込み、変更、破棄された後は無効です