PDFium Delphi Component Docs

フォームホストコールバック

コンポーネント: TPdf  ·  ユニット: PDFium
PDFium のフォーム操作をホスト側のナビゲーション、URI、カーソル、変更、ページ、選択の各動作に接続します

プロパティとイベント

property FormHostCallbacksComplete: Boolean; // read only

property FormSelectionRects: TPdfFormSelectionRects; // read only

procedure ClearFormSelectionRects;

property OnFormCursor: TPdfFormCursorEvent;

property OnFormValueChange: TPdfFormValueChangeEvent;

property OnFormUriAction: TPdfFormUriActionEvent;

property OnFormGoToAction: TPdfFormGoToActionEvent;

property OnFormSelectionRect: TPdfFormSelectionRectEvent;

ページの所有権

ドキュメントの JavaScript は、まだどのビューも開いていないページを要求することがあります。そのためフォームホストはページを遅延読み込みし、要求されたページごとに 1 つのハンドルを保持し、ネイティブのページオープン通知を送り、フォーム環境が閉じる前にすべてのハンドルを解放します

FormHostCallbacksComplete は、フォーム環境が必要なバージョン 1 のコールバックをすべてインストールした後に true になります

ナビゲーションと URI アクション

OnFormGoToAction は、1 始まりのページ番号、ネイティブのズームモード、および移動先位置配列の範囲内のコピーを受け取ります

GoTo を未処理のままにすると、フォーム操作を開始したビューのページが変更され、ヘッドレス利用の場合は TPdf.PageNumber にフォールバックします。ホスト側で Handled を設定し、移動先へのスクロールやズームを自前で適用することもできます

OnFormUriAction は、AcroForm と XFA の両方のアクションについて、デコード済みと生の URI 値に加えてキーボードモディファイアを受け取ります。ホストが起動を選択しない限り、外部の起動は行われません

カーソル、変更、選択矩形

OnFormCursor は、安定した TPdfFormCursor 値と元のネイティブカーソルコードの両方を受け取ります。安定値は pfcUnknownpfcArrowpfcSizeNESWpfcSizeNWSEpfcVerticalBeampfcHorizontalBeampfcHand のいずれかであり、未処理のままにするとフォーム操作を開始したビューのみが更新されます

OnFormValueChange は、派生ページキャッシュを無効化した後に実行され、入れ子になった変更通知を統合します

FormSelectionRects は、ネイティブのフォームテキスト選択から最大 4096 個のページ空間矩形を呼び出し側所有のスナップショットとして返します。OnFormSelectionRect は新しい矩形を 1 つずつストリームし、ClearFormSelectionRects は保持されたジオメトリをクリアします

関連項目

FormFieldInfo, FormFieldTypeAtPoint, TPdfView.FormFieldInfoAt