Component Synchronizer の動作 - ABBYY Documentation

Visual Components は、Windows 版 FRE に実装されています。

Component Synchronizer は、Visual Components で発生するさまざまなイベントに自動的に応答する特別なコンポーネントです。複数の Visual Components を Synchronizer に接続すると、それらを 1 つのアプリケーションとして動作させることができます。接続されているコンポーネントすべてを Component Synchronizer で使用する必要はなく、必要なものだけを接続できます。たとえば、Image Viewer は ImageViewer プロパティを介して、Text Editor は TextEditor プロパティを介して接続できます。 Component Synchronizer にはユーザーインターフェイスがありません。また、Visual Components の内部機能は使用せず、各コンポーネントの COM API のみを使用します。Component Synchronizer は以下のように動作します。

コンポーネントがAPIを通じてSynchronizerに接続されている場合

コンポーネントまたはオブジェクトがComponent Synchronizerに接続されている場合:

ImageViewer property

この場合、IComponentSynchronizer::ImageViewer propertyに指定の ImageViewer オブジェクトが設定され、続いて以下の操作が実行されます:

property	設定値
	True

	IComponentSynchronizer::Document 内で IComponentSynchronizer::PageIndex インデックスに対応するページ

ZoomViewer property

この場合、IComponentSynchronizer::ZoomViewer propertyに指定の ZoomViewer オブジェクトが設定され、続いて以下の操作が実行されます:

property	設定値
	True

	IComponentSynchronizer::Document 内で IComponentSynchronizer::PageIndex インデックスに対応するページ

TextEditor property

この場合、IComponentSynchronizer::TextEditor propertyに指定の TextEditor オブジェクトが設定され、続いて以下の操作が実行されます:

property	設定値
	SynthesisParamsForDocument propertyの値 ( IComponentSynchronizer::DocumentProcessingParams オブジェクト)
	IComponentSynchronizer::Document 内で IComponentSynchronizer::PageIndex インデックスに対応するページ

TextValidator property

この場合、IComponentSynchronizer::TextValidator propertyに指定の TextValidator オブジェクトが設定され、続いて以下の操作が実行されます:

property	設定値
	SynthesisParamsForDocument propertyの値 ( IComponentSynchronizer::DocumentProcessingParams オブジェクト)

DocumentViewer property

In this case, the IComponentSynchronizer::DocumentViewer property is set to the specified DocumentViewer object, and then the following operations are performed:

The property	Is set to


	The ページ in the IComponentSynchronizer::Document with the IComponentSynchronizer::PageIndex index

Document property

In this case, the IComponentSynchronizer::Document property is set to the specified FRDocument object, and then the following operations are performed:

The property	Is set to
	The first ページ in the IComponentSynchronizer::Document
	0

DocumentProcessingParams property

In this case, the IComponentSynchronizer::DocumentProcessingParams property is set to the specified DocumentProcessingParams object, and then the following operations are performed:

The property	Is set to

	The value of the SynthesisParamsForDocument property of the IComponentSynchronizer::DocumentProcessingParams object

PageIndex property

In this case, the IComponentSynchronizer::PageIndex property is set to the specified value, and then the following operations are performed:

The property	Is set to
	The ページ in the IComponentSynchronizer::Document with the IComponentSynchronizer::PageIndex index

接続されたコンポーネントがイベントを発生させた場合

接続された Image Viewer のイベント:

OnMouseButtonUp イベント

Image Viewer で OnMouseButtonUp イベントが発生すると、Component Synchronizer は次の操作を実行します。

if( mouseButton == MBU_LeftButton && ZoomViewer != 0 ) {
 int documentX = 0;
 int documentY = 0;
 ImageViewer->ScreenToDocument( x, y, &documentX, &documentY );
 ZoomViewer->CenterOnDocumentPoint( documentX, documentY );
}

OnBlockSelectionChanged イベント

Image Viewer で OnBlockSelectionChanged イベントが発生すると、Component Synchronizer は次の操作を実行します。

if( selected == VARIANT_TRUE ) {
 if( textEditor != 0 ) {
  textEditor->ShowBlock( blockIndex, NotFound );
 }
}

OnTableSelected イベント

Image Viewer で OnTableCellsSelected イベントが発生すると、Component Synchronizer は選択されたブロックのインデックスと右下のセルのインデックスを指定して、TextEditor オブジェクトの ShowBlock メソッドを呼び出します。

OnAfterDblClick イベント

Image Viewer で OnAfterDblClick イベントが発生すると、Component Synchronizer は次の操作を実行します。

if( textEditor != 0 ) {
 textEditor->ActivateOn( blockIndex, x, y );
}

OnActivePageChanged イベント

Image Viewer で OnActivePageChanged イベントが発生し、ComponentSynchronizer オブジェクトの ZoomViewer、TextEditor、DocumentViewer の各プロパティがすでに設定されている場合、対応するコンポーネントの FRPage または ActivePage プロパティが、文書の指定されたページに設定されます。

OnSelectTool イベント

Image Viewer で OnSelectTool イベントが発生すると、Component Synchronizer は次の操作を実行します。

if( ZoomViewer == 0 ) {
 return;
}
IFRPagePtr curPage;
ZoomViewer->get_FRPage( &curPage );
if( curPage != 0 ) {
 ZoomViewer->put_ActiveTool( selectedTool );
}

OnOptionsChanged イベント

Image Viewer で OnOptionsChanged イベントが発生し、ComponentSynchronizer オブジェクトの ZoomViewer、DocumentViewer、TextEditor、TextValidator の各プロパティがすでに設定されている場合、ZoomViewer、DocumentViewer、TextEditor、TextValidator の各オブジェクトの UpdateOptions メソッドが呼び出されます。

接続された Zoom Viewer のイベント:

OnVisibleDocumentAreaChanged イベント

Zoom Viewer で OnVisibleDocumentAreaChange イベントが発生すると、Component Synchronizer は次の操作を実行します。

if( ImageViewer != 0 ) {
 ImageViewer->put_ZoomRect( visibleRect );
 if( isInFocus ) {
  ImageViewer->ShowDocumentArea( visibleRect );
 }
}

OnBlockSelectionChanged イベント

Zoom Viewer で OnBlockSelectionChanged イベントが発生すると、Component Synchronizer は次の操作を実行します。

if( selected == VARIANT_TRUE ) {
 if( textEditor != 0 ) {
  textEditor->ShowBlock( blockIndex, NotFound );
 }
}

OnTableCellsSelected イベント

Zoom Viewer で OnTableCellsSelected イベントが発生すると、Component Synchronizer は選択されたブロックのインデックスと右下のセルのインデックスを指定して、TextEditor オブジェクトの ShowBlock メソッドを呼び出します。

OnAfterDblClick イベント

Zoom Viewer が OnAfterDblClick イベントを発生させると、Component Synchronizer は次の処理を実行します。

if( textEditor != 0 ) {
 textEditor->ActivateOn( blockIndex, x, y );
}

OnActivePageChanged イベント

Zoom Viewer が OnActivePageChanged イベントを発生させ、かつ ComponentSynchronizer object の ImageViewer、TextEditor、DocumentViewer プロパティがすでに設定されている場合、対応する component の FRPage または ActivePage プロパティが、Document の指定されたページに設定されます。

OnSelectTool イベント

Zoom Viewer が OnSelectTool イベントを発生させると、Component Synchronizer は次の処理を実行します。

if( ImageViewer == 0 ) {
 return;
}
IFRPagePtr curPage;
ImageViewer->get_FRPage( &curPage );
if( curPage != 0 ) {
 ImageViewer->put_ActiveTool( selectedTool );
}

OnOptionsChanged イベント

Zoom Viewer が OnOptionsChanged イベントを発生させ、かつ ComponentSynchronizer object の ImageViewer、DocumentViewer、TextEditor、TextValidator プロパティがすでに設定されている場合、ImageViewer、DocumentViewer、TextEditor、TextValidator objects の UpdateOptions メソッドが呼び出されます。

接続された Document Viewer のイベント:

OnActivePageChanged イベント

Document Viewer が OnActivePageChanged イベントを発生させ、かつ ComponentSynchronizer object の ImageViewer、ZoomViewer、TextEditor プロパティがすでに設定されている場合、対応する component の FRPage プロパティが、Document の指定されたページに設定されます。

OnDocumentChanged イベント

Document Viewer が OnDocumentChanged イベントを発生させ、かつ ComponentSynchronizer object の ImageViewer、ZoomViewer、TextEditor、TextValidator プロパティがすでに設定されている場合:

TextValidator object の FRDocument プロパティが新しい Document に設定されます
ImageViewer、ZoomViewer、TextEditor objects の FRPage プロパティと DocumentViewer object の ActivePage プロパティが、新しい Document の最初のページに設定されます

OnOptionsChanged イベント

Document Viewer が OnOptionsChanged イベントを発生させ、かつ ComponentSynchronizer object の ImageViewer、ZoomViewer、TextEditor、TextValidator プロパティがすでに設定されている場合、ImageViewer、ZoomViewer、TextEditor、TextValidator objects の UpdateOptions メソッドが呼び出されます。

接続された Text Editor のイベント:

OnEditorBlockChanged イベント

Text Editor が OnEditorBlockChanged イベントを発生させると、ComponentSynchronizer は次の処理を実行します。

ComponentSynchronizer object の ImageViewer、ZoomViewer プロパティがすでに設定されている場合、指定された block に対して、ImageViewer object と ZoomViewer object の SetSelectedBlocksIndices メソッドが呼び出されます。
それがテーブルブロックの場合、選択されたセルに対して、ImageViewer object と ZoomViewer object の SetSelectedCells メソッドが呼び出されます。
次に、ImageViewer object と ZoomViewer object の ShowDocumentArea メソッドが呼び出されます。

OnSymbolSelected イベント

Text Editor が OnSymbolSelected イベントを発生させると、Component Synchronizer は次の処理を実行します。

if( ZoomViewer != 0 ) {
 ZoomViewer->put_SymbolRect( symbolRect );
}
if( ImageViewer != 0 ) {
 ImageViewer->ShowDocumentArea( symbolRect );
}
if( ZoomViewer != 0 ) {
 ZoomViewer->ShowDocumentArea( symbolRect );
}

OnActivePageChanged イベント

Text Editor で OnActivePageChanged イベントが発生し、Component Synchronizer オブジェクトの ImageViewer、ZoomViewer、DocumentViewer の各プロパティがすでに設定されている場合、対応するコンポーネントの FRPage または ActivePage プロパティが、文書内の指定されたページに設定されます。

OnOptionsChanged イベント

Text Editor で OnOptionsChanged イベントが発生し、Component Synchronizer オブジェクトの ImageViewer、ZoomViewer、DocumentViewer、TextValidator の各プロパティがすでに設定されている場合、ImageViewer、ZoomViewer、DocumentViewer、TextValidator オブジェクトの UpdateOptions メソッドが呼び出されます。

接続されている Text Validator のイベント:

OnSymbolSelected イベント

Text Validator で OnSymbolSelected イベントが発生すると、Component Synchronizer は次の処理を実行します:

if( ZoomViewer != 0 ) {
 ZoomViewer->put_SymbolRect( symbolRectangle );
}

OnSelectionChanged イベント

Text Validator で OnSelectionChanged イベントが発生すると、Component Synchronizer は次の処理を実行します:

int symbolPos;
IEditorPosition* nextPosition;
position->get_Symbol( &symbolPos );
nextPosition->put_Symbol( symbolPos + length );
if( textEditor != 0 ) {
 textEditor->SetSelection( position, nextPosition );
}

OnActivePageChanged イベント

Text Validator で OnActivePageChanged イベントが発生し、Component Synchronizer オブジェクトの ImageViewer、ZoomViewer、TextEditor、DocumentViewer の各プロパティがすでに設定されている場合、対応するコンポーネントの FRPage または ActivePage プロパティが、文書内の指定されたページに設定されます。

OnDocumentChanged イベント

Text Validator で OnDocumentChanged イベントが発生し、Component Synchronizer オブジェクトの ImageViewer、ZoomViewer、TextEditor、DocumentViewer の各プロパティがすでに設定されている場合:

DocumentViewer オブジェクトの FRDocument プロパティが新しい文書に設定されます
ImageViewer、ZoomViewer、TextEditor オブジェクトの FRPage プロパティと、DocumentViewer オブジェクトの ActivePage プロパティが、新しい文書の最初のページに設定されます。

OnOptionsChanged イベント

Text Validator で OnOptionsChanged イベントが発生し、Component Synchronizer オブジェクトの ImageViewer、ZoomViewer、TextEditor、DocumentViewer の各プロパティがすでに設定されている場合、ImageViewer、ZoomViewer、TextEditor、DocumentViewer オブジェクトの UpdateOptions メソッドが呼び出されます。

​コンポーネントがAPIを通じてSynchronizerに接続されている場合

​接続されたコンポーネントがイベントを発生させた場合

​関連項目

コンポーネントがAPIを通じてSynchronizerに接続されている場合

接続されたコンポーネントがイベントを発生させた場合

関連項目