メインコンテンツへスキップ
ビジュアルコンポーネントは Windows 版 FRE で実装されています。
DocumentViewer オブジェクトは、ドキュメント内のページ一覧を表示してその状態を監視できる ActiveX コントロールです。また、認識済みのドキュメントを保存したり、コンポーネントで使用可能なコマンドを使って、選択したアプリケーションで開いたりすることもできます。ドキュメントは FRDocument プロパティを介してコンポーネントに接続されます。 Document Viewer コンポーネントは、Mode プロパティの値に応じて次のいずれかの表示になります。
  • 詳細表示
各ドキュメントページの詳細情報を表示します。 DocumentViewer_Details
  • サムネイル表示
ドキュメントページをサムネイルで表示します。 DocumentViewer_Thumbnails コンポーネントの外観は、そのプロパティを使って変更できます。たとえば、Toolbar プロパティを介してツールバーにボタンを追加または削除したり、PopupMenu プロパティを介してコンポーネントのコンテキストメニューを変更したりできます。詳しくは、ビジュアルコンポーネントのコンテキストメニューとツールバーのカスタマイズを参照してください。 ドキュメントの監視に関する情報は、特別な送出インターフェイスを通じて通知されます。これらのインターフェイスは、IDocumentViewerEvents (C++ 用) と、dispinterface DIDocumentViewerEvents (Visual Basic 用) です。 なお、Visual Basic ユーザーは、イベントインターフェイス実装の詳細を気にする必要はありません。この開発プラットフォームには、それらを簡単に処理する手段が用意されているためです。このオブジェクトは、Visual Basic では WithEvents として宣言できます。 C++ ユーザーにとって、これは IConnectionPointContainer インターフェイスをサポートしていることを意味します。イベント通知を受け取るには、C++ ユーザーは IDocumentViewerEvents インターフェイスから派生したオブジェクトを作成し、次に、そのオブジェクトと DocumentViewer オブジェクトに実装されているイベントソースとの接続を、標準の COM の方法で設定する必要があります。 Document Viewer コンポーネントは、Component Synchronizer コンポーネントに接続できます。この場合、Document Viewer 内のすべてのイベントは Synchronizer に接続された他のコンポーネントに自動的に送信され、アプリケーション全体が同期して動作します。

プロパティ

Document Viewerのアクティブ ページを指定します。アクティブ ページが存在しない場合、このプロパティの値は0です。

Document Viewerのキャプションペインが有効かどうかを指定します。このプロパティがFALSEの場合、キャプションペインは表示されません。

デフォルト値はTRUEです。

Document Viewerのコンテキストメニューが有効かどうかを指定します。このプロパティがFALSEの場合、コンテキストメニューは表示されません。

デフォルト値はTRUEです。

,read-only

Document Viewerで使用可能なコマンドへのアクセスを提供します。Document Viewerで使用可能なコマンドの一覧を参照してください。

Document Viewerに接続されているドキュメントを指定します。

Document Viewerの言語ページが有効かどうかを指定します。このプロパティがFALSEの場合、言語ページは表示されません。

デフォルト値はTRUEです。

Document Viewerがロックされているかどうかを指定します。

このプロパティは次の状況で役立ちます。

  • 解析、認識、合成、またはエクスポート操作がFineReader Engine API (ビジュアルコンポーネントからではなく) から呼び出される場合、または
  • アプリケーションが特定のイベントの通知 (例:オブジェクトから) を受け取り、これらのイベントハンドラー内でビジュアルコンポーネントからのWindowsメッセージを処理する場合。

この場合、解析、認識、合成、またはエクスポートの実行前にこのプロパティをTRUEに設定し、操作完了後にFALSEに設定することを推奨します。これにより、Document Viewerからドキュメントが破損するのを防ぐことができます。

デフォルト値はFALSEです。

Document Viewerの現在のモード (詳細表示またはサムネイル表示) を指定します。

デフォルトのモードはDVM_Thumbnailsです。

,read-only

コンテキストメニューの設定へのアクセスを提供します。

ドキュメントのデフォルト処理パラメーターを指定します。これらの パラメーターは、分析および認識プロセスが Document Viewer から直接呼び出される場合に使用されます。

Document Viewer が Component Synchronizer に接続されている場合は、IComponentSynchronizer::ProcessingParamsプロパティを使用して処理パラメーターを変更してください。Document Viewer のプロパティを通じて処理パラメーターを変更した場合、エラーが発生する可能性があります。

Document Viewer コンポーネントのタイトルを指定します。

デフォルト値は “Pages” です。

,read-only

ツールバーの設定にアクセスします。

選択されたページのインデックスのコレクションにアクセスします。

Document Viewer の設定ファイルが格納されているフォルダーへのパスを指定します。他のビジュアルコンポーネントにも同じプロパティがあります。各ビジュアルコンポーネントは、それぞれ専用の設定フォルダーを使用する必要があります。

このプロパティの値は、ABBYY FineReader Engine がユーザー固有のデータを保存するフォルダーへのパスと、そのサブフォルダーの名前から構成されます。デフォルトでは、ユーザー固有のデータが格納されるフォルダーはFineReader Engine data folderです。このフォルダーは FineReader Engine の初期化時に (関数、またはメソッドを使用して) 変更できます。サブフォルダーのデフォルト名は任意の GUID です。サブフォルダーの名前を変更するには、デザイン時に Visual Studio でコンポーネントのプロパティに新しい名前を指定する必要があります。実行時にプロパティの値を指定しようとしても、その値は無視されます。

デザイン時に Visual Studio のフォームにコンポーネントを追加した場合、プロパティの値はデフォルト値で自動的に設定されるか、カスタム値で手動で設定されます。いずれの場合も、値はデザイン時に定義されます。何らかの理由でデザイン時にプロパティの値が定義されていない場合 (例:実行時にコンポーネントを動的に生成する場合) 、コンポーネントは初期化のたびに新しい設定フォルダーを作成します。フォルダーが増え続けるのを防ぐには、コンポーネントの初期化解除後に作成された設定フォルダーを削除する必要があります。この場合、コンポーネントのデフォルト設定のみを使用でき、セッション間で設定を保存することはできません。

、読み取り専用

クライアント領域のウィンドウ ハンドルを返します。

メソッド

名前説明
UpdateOptionsDocument Viewer のオプションダイアログで指定した設定を更新します。別のビジュアルコンポーネントでオプションが変更された場合は、Document Viewer のオプションを現在の状態に反映するために、このメソッドを呼び出す必要があることがあります。

サンプル

このコンポーネントは、以下のコードサンプルで使用されています: VisualComponents

関連項目

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer GUI を備えたアプリケーションの作成 ビジュアルコンポーネントのコンテキストメニューとツールバーのカスタマイズ