Visual Components は Windows 版 FRE で実装されています。
これは、ImageViewer オブジェクトからリスナーにイベントを通知するための Callback インターフェイスです。このインターフェイスはクライアント側に実装されます。使用している開発ツール向けの詳細な実装ガイダンスについては、Working with Connectable Objects を参照してください。
このインターフェイスは IInputEvents インターフェイスから派生しており、そのすべてのメソッドを継承します。
このインターフェイスのメソッドを通じて通知を受け取るオブジェクトは、各メソッドの実装内で次のことを実行できます。
- ブロックの選択、画像の編集、解析、認識に関する情報を通知し、これらの操作をキャンセルする。
- マウスの移動やクリック、キー押下、スクロールに関する情報を通知する。
- 長時間の処理中にアプリケーションが応答していないように見えるのを防ぐため、任意のシステムメッセージを処理する。これは、ユーザーインターフェイスを備えたアプリケーションで役立ちます。
| 名前 | 説明 |
|---|
| OnActivePageChanged | Image Viewer でアクティブ ページが変更された後に呼び出されます。クライアントに新しいページへの参照を渡します。 |
| OnActivePageChanging | Image Viewer でアクティブ ページが変更される前に呼び出されます。新しいアクティブ ページへの参照がクライアントに渡されます。操作をキャンセルできます。 |
| OnAfterDblClick | Image Viewer で認識済みのブロック内の位置がダブルクリックされた後に呼び出されます。ダブルクリックされたブロックの index と、その中の点の座標が client に渡されます。 |
| OnAnalyzePage | Image Viewer から開始されたページ解析処理の開始前に呼び出されます。操作をキャンセルできます。 |
| OnAnalyzeRegion | Image Viewer から開始されたブロック解析処理が始まる前に呼び出されます。これから解析される領域の座標をクライアントに渡します。この処理をキャンセルできます。 |
| OnAnalyzeTable | Image Viewer から呼び出された表解析処理の開始前に呼び出されます。これから解析される Block のインデックスがクライアントに渡されます。操作をキャンセルできます。 |
| OnBlockAdded | Image Viewer で新しい Block が追加された後に呼び出されます。 |
| OnBlockSelectionChanged | Image Viewer、または Image Viewer と同期された Zoom Viewer で Block の選択が変更された後に呼び出されます。新しく選択された Block のインデックスがクライアントに渡されます。 |
| OnChangeBlockType | Image Viewer または Image Viewer と同期している Zoom Viewer でブロックの型が変更された後に呼び出されます。型の変更をキャンセルできます。 |
| OnCorrectPerspective | 画像ページの遠近歪みを補正する前に呼び出されます。変更対象のページのインデックスと、補正後のページ四隅の座標がクライアントに渡されます。この操作はキャンセルできます。 |
| OnCorrectResolution | 画像の解像度を変更する前に呼び出されます。解像度が補正されるページのインデックスと新しい解像度の値がクライアントに渡され、操作をキャンセルできます。 |
| OnCropImages | 画像を切り抜く前に呼び出されます。切り抜き対象のページのインデックスと、切り抜き矩形の座標がクライアントに渡されます。操作をキャンセルできます。 |
| OnDeleteBlocks | Image Viewer でブロックを削除する前に呼び出されます。削除対象のブロックのインデックスがクライアントに渡されます。操作をキャンセルできます。 |
| OnEditImages | 画像編集の開始前に呼び出されます。編集対象となるページのインデックスと、編集に使用するコマンドに関する情報をクライアントに通知します。操作をキャンセルできます。 |
| OnLocked | Image Viewer がロックまたはロック解除された後に呼び出されます。Image Viewer コンポーネントがロック状態かロック解除状態かに関する情報をクライアントに通知します。 |
| OnLongOperationFinished | Image Viewer での長時間の処理操作 (例: レイアウト解析、認識) が終了した後に呼び出されます。 |
| OnLongOperationStarted | Image Viewer で長時間の処理 (レイアウト解析や認識など) が開始される前に呼び出されます。 |
| OnOptionsChanged | Image Viewer でオプションが変更された後に呼び出されます。オプションは、MI_Options コマンドを呼び出すと表示されるオプション ダイアログで指定します。 |
| OnPagesSelectionChanged | Image Viewer の Image Editor ダイアログでページの選択が変更された後に呼び出されます。 |
| OnProgress | ページの処理中に呼び出されます。現在の解析または認識処理のおおよその進行率をクライアントに通知します。処理をキャンセルできます。 |
| OnReadBlocks | Image Viewer から呼び出されたブロック認識処理の開始前に呼び出されます。認識対象となるブロックのインデックスをクライアントに通知します。処理をキャンセルできます。 |
| OnReadPage | Image Viewer から開始されるページ認識処理の開始前に呼び出されます。処理をキャンセルできます。 |
| OnScale | Image Viewer で画像の拡大・縮小を行う前に呼び出されます。スケール値をクライアントに渡します。操作はキャンセルできます。 |
| OnSelectTool | Image Viewer、または Image Viewer と同期している Zoom Viewer でツールが選択された後に呼び出されます。選択されたツールに関する情報をクライアントに渡します。 |
| OnSplitImages | 画像を分割する前に呼び出されます。分割対象の画像と、分割に使用される領域に関する情報をクライアントに渡します。この操作はキャンセルできます。 |
| OnTableCellsSelected | Image Viewer または Image Viewer と同期した Zoom Viewer でテーブルセルが選択されると、その後に呼び出されます。選択されたセルが含まれるテーブルブロックの index と、選択されたセルを囲む矩形に関する情報をクライアントに渡します。 |
| OnToolAddBlock | Image Viewer のツールで描画した新しいブロックを追加する前に呼び出されます。描画されたブロックに関する情報 (型と領域) がクライアントに渡されます。この操作をキャンセルできます。 |
| OnToolChangeBlockRegion | Image Viewer のツールで変更された Block の領域を変更する前に呼び出されます。変更される領域を持つ Block に関する情報と、変更後の Block の新しい領域をクライアントに渡します。この操作はキャンセルできます。 |
| OnToolChangeTable | Image Viewer のツールで変更されたテーブルブロックを変更する前に呼び出されます。変更対象のテーブルブロックのインデックスと、追加または削除される区切り線の位置および型がクライアントに渡されます。操作をキャンセルできます。 |
| OnToolEraseRect | Image Viewer のツールを使用してこの処理が開始された場合に、画像の一部を消去する前に呼び出されます。編集対象のページに関する情報と、消去矩形の座標がクライアントに渡されます。操作をキャンセルできます。 |
| OnVisibleDocumentAreaChange | Image Viewer で可視領域が変更された後に呼び出されます。新しい可視領域の座標をクライアントに渡します。 |
このインターフェイスは、次のコードサンプルで使用されています: VisualComponents.
Working with Connectable Objects
ImageViewer