メインコンテンツへスキップ
ビジュアルコンポーネントは、Windows 用 FRE で実装されています。
TextEditor オブジェクトは、ドキュメントページ上の認識されたテキストを表示および編集できる ActiveX コントロールです。ページは、FRPage プロパティを介してこのコンポーネントに関連付けられます。 Text Editor コンポーネントは次のようになります。 TextEditor このコンポーネントの外観は、プロパティを使って変更できます。たとえば、Toolbar プロパティを使用してツールバーにボタンを追加または削除したり、Commands プロパティを使用してコンポーネントのコンテキストメニューを変更したりできます。詳細については、ビジュアルコンポーネントのコンテキストメニューとツールバーのカスタマイズを参照してください。 認識されたテキストの編集に関する情報は、特別な出力インターフェイスを通じて通知されます。これらのインターフェイスは、ITextEditorEvents (C++ 用) および dispinterface DITextEditorEvents (Visual Basic 用) です。 なお、Visual Basic ユーザーは、イベントインターフェイス実装の詳細を気にする必要はありません。この開発プラットフォームには、イベントを簡単に処理するための手段が用意されているためです。このオブジェクトは、Visual Basic では WithEvents として宣言できます。 C++ ユーザーにとって、これは IConnectionPointContainer インターフェイスをサポートしていることを意味します。イベント通知を受け取るには、ITextEditorEvents インターフェイスから派生したオブジェクトを作成し、標準的な COM の手段を使用して、そのオブジェクトと TextEditor オブジェクトに実装されているイベントソースとの間の接続を設定する必要があります。 Text Editor コンポーネントは、Component Synchronizer コンポーネントに接続できます。その場合、Text Editor 内のすべてのイベントは Synchronizer に接続されているほかのコンポーネントに自動的に伝達され、アプリケーション全体が同期して動作します。

プロパティ

Text Editorの下部ペインが有効かどうかを指定します。このプロパティがFALSEの場合、下部ペインは表示されません。

デフォルト値はTRUEです。

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

デフォルト値はTRUEです。

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

デフォルト値はTRUEです。

,read-only

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

ページ上のカーソル位置を指定します。

Text Editorに接続されたドキュメントページを表します。

Text Editorでテキスト色と背景色を保持するかどうかを指定します。

このプロパティのデフォルト値はTRUEです。

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

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

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

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

デフォルト値はFALSEです。

ドキュメントの表示モードのいずれかを指定します。

デフォルト値はTEM_ExactCopyです。

,read-only

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

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

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

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

Text Editorに画像を表示するかどうかを指定します。

デフォルトでは、このプロパティの値はTRUEです。

Text Editorにランニングタイトルを表示するかどうかを指定します。

デフォルトでは、このプロパティの値はTRUEです。

文書のデフォルト文書合成パラメーターを指定します。これらのパラメーターは、Text Editorが文書合成を実行する必要がある場合に使用されます (編集操作によって文書の論理構造が不正になった場合に発生することがあります) 。

Text EditorがComponent Synchronizerに接続されている場合は、IComponentSynchronizer::ProcessingParamsプロパティを使用して文書合成のパラメーターを変更してください。Text Editorのプロパティからこれらのパラメーターを変更すると、エラーが発生する場合があります。

,read-only

現在の文字の矩形座標をピクセル単位で保持します。座標は文書画像を基準とした相対値です。

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

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

,read-only

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

テキストページの表示倍率をパーセントで指定します。このプロパティには定数のいずれかを設定することもできます。

デフォルト値はST_BestFitで、最適なフィットが自動的に選択されます。

,read-only

可視領域の座標をピクセル単位で格納します。座標は文書画像を基準とした相対値です。

、読み取り専用

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

メソッド

NameDescription
ActivateOn指定したブロック内の位置をアクティブにし、その位置が表示されるようにします。
CenterOnDocumentPoint指定した文書上の点がビューの中央に表示されるように、テキストビューをスクロールします。
DocumentToScreen文書画像上の指定した点の座標を画面座標に変換します。
GetSelection選択範囲の開始位置と終了位置を返します。
Print認識されたテキストを印刷します。
SetSelectionページ上のテキストの選択範囲を設定します。
ScreenToDocument指定した点の画面座標を文書画像上の座標に変換します。
ShowBlock指定したブロックが表示されるようにします (可能な範囲で) 。このメソッドが有効なのは、Text Editor を TEM_ExactCopy モードで使用している場合のみです。
ShowDocumentArea指定した座標の文書領域が表示されるように、テキストビューをスクロールします (可能な範囲で) 。
UpdateOptionsText Editor のオプションダイアログで指定した設定を更新します。別のビジュアルコンポーネントでオプションが変更された場合は、Text Editor のオプションを現在の状態に更新するために、このメソッドを呼び出す必要があります。

サンプル

このコンポーネントは、次のコード例で使用されています: VisualComponents

関連項目

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