Component Synchronizer 的運作方式

Visual Components 是在 Windows 版 FRE 中實作的。

Component Synchronizer 是一種特殊元件，會對 Visual Components 中發生的各種事件自動作出回應。您可以將多個 Visual Components 連接到 Synchronizer，讓它們像單一應用程式一樣運作。

您無需將整組元件全部連接到 Component Synchronizer，只要連接您實際會用到的元件即可。例如，您可以僅透過 ImageViewer 屬性將 Image Viewer 連接至其中，並透過 TextEditor 屬性將 Text Editor 連接至其中。

Component Synchronizer 沒有使用者介面。它不使用 Visual Components 的任何內部功能，而只使用這些元件的 COM API。Component Synchronizer 的運作方式如下。

​

當元件透過 API 連線至同步器時

如果元件或物件透過下列方式連線至元件同步器：

ImageViewer 屬性

在此情況下，IComponentSynchronizer::ImageViewer 屬性會設為指定的 ImageViewer 物件，然後執行下列作業：

屬性	設為
	True
	IComponentSynchronizer::Document 中索引為 IComponentSynchronizer::PageIndex 的頁面

ZoomViewer 屬性

在此情況下，IComponentSynchronizer::ZoomViewer 屬性會設為指定的 ZoomViewer 物件，然後執行下列作業：

屬性	設為
	True
	IComponentSynchronizer::Document 中索引為 IComponentSynchronizer::PageIndex 的頁面

TextEditor 屬性

在此情況下，IComponentSynchronizer::TextEditor 屬性會設為指定的 TextEditor 物件，然後執行下列作業：

屬性	設為
	IComponentSynchronizer::DocumentProcessingParams 物件的 SynthesisParamsForDocument 屬性值
	IComponentSynchronizer::Document 中索引為 IComponentSynchronizer::PageIndex 的頁面

TextValidator 屬性

在此情況下，IComponentSynchronizer::TextValidator 屬性會設為指定的 TextValidator 物件，然後執行下列作業：

屬性	設為
	IComponentSynchronizer::DocumentProcessingParams 物件的 SynthesisParamsForDocument 屬性值

DocumentViewer 屬性

在此情況下，IComponentSynchronizer::DocumentViewer 屬性會設為指定的 DocumentViewer 物件，接著執行下列操作：

屬性	設為
	IComponentSynchronizer::Document 中索引為 IComponentSynchronizer::PageIndex 的頁面

Document 屬性

在此情況下，IComponentSynchronizer::Document 屬性會設為指定的 FRDocument 物件，接著執行下列操作：

屬性	設為
	IComponentSynchronizer::Document 中的第一頁
	0

DocumentProcessingParams 屬性

在此情況下，IComponentSynchronizer::DocumentProcessingParams 屬性會設為指定的 DocumentProcessingParams 物件，接著執行下列操作：

屬性	設為
	IComponentSynchronizer::DocumentProcessingParams 物件的 SynthesisParamsForDocument 屬性值

PageIndex 屬性

在此情況下，IComponentSynchronizer::PageIndex 屬性會設為指定的值，接著執行下列操作：

屬性	設為
	IComponentSynchronizer::Document 中索引為 IComponentSynchronizer::PageIndex 的頁面

​

當連接的元件產生事件時

已連接的 Image Viewer 事件：

OnMouseButtonUp 事件

如果 Image Viewer 產生 OnMouseButtonUp 事件，元件同步器會執行下列操作：

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 事件，元件同步器會執行下列操作：

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

OnTableSelected 事件

如果 Image Viewer 產生 OnTableCellsSelected 事件，元件同步器會以所選 Block 的索引和右下角儲存格索引，呼叫 TextEditor 物件的 ShowBlock 方法。

OnAfterDblClick 事件

如果 Image Viewer 產生 OnAfterDblClick 事件，元件同步器會執行下列操作：

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

OnActivePageChanged 事件

如果 Image Viewer 產生 OnActivePageChanged 事件，且 ComponentSynchronizer 物件的 ZoomViewer、TextEditor、DocumentViewer 屬性都已設定，則對應元件的 FRPage 或 ActivePage 屬性會設為文件中指定的頁面。

OnSelectTool 事件

如果 Image Viewer 產生 OnSelectTool 事件，元件同步器會執行下列操作：

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 事件，元件同步器會執行下列操作：

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

OnBlockSelectionChanged 事件

如果 Zoom Viewer 產生 OnBlockSelectionChanged 事件，元件同步器會執行下列操作：

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

OnTableCellsSelected 事件

如果 Zoom Viewer 產生 OnTableCellsSelected 事件，元件同步器會以所選 Block 的索引和右下角儲存格索引，呼叫 TextEditor 物件的 ShowBlock 方法。

OnAfterDblClick 事件

如果 Zoom Viewer 觸發 OnAfterDblClick 事件，元件同步器會執行下列操作：

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

OnActivePageChanged 事件

如果 Zoom Viewer 觸發 OnActivePageChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、TextEditor、DocumentViewer 屬性皆已設定，則對應元件的 FRPage 或 ActivePage 屬性會設為文件中指定的頁面。

OnSelectTool 事件

如果 Zoom Viewer 觸發 OnSelectTool 事件，元件同步器會執行下列操作：

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

OnOptionsChanged 事件

如果 Zoom Viewer 觸發 OnOptionsChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、DocumentViewer、TextEditor、TextValidator 屬性皆已設定，則會呼叫 ImageViewer、DocumentViewer、TextEditor 和 TextValidator 物件的 UpdateOptions 方法。

已連接的 Document Viewer 事件：

OnActivePageChanged 事件

如果 Document Viewer 觸發 OnActivePageChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、TextEditor 屬性皆已設定，則對應元件的 FRPage 屬性會設為文件中指定的頁面。

OnDocumentChanged 事件

如果 Document Viewer 觸發 OnDocumentChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、TextEditor、TextValidator 屬性皆已設定：

• TextValidator 物件的 FRDocument 屬性會設為新的文件
• ImageViewer、ZoomViewer 和 TextEditor 物件的 FRPage 屬性，以及 DocumentViewer 物件的 ActivePage 屬性，會設為新文件的第一頁

OnOptionsChanged 事件

如果 Document Viewer 觸發 OnOptionsChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、TextEditor、TextValidator 屬性皆已設定，則會呼叫 ImageViewer、ZoomViewer、TextEditor 和 TextValidator 物件的 UpdateOptions 方法。

已連接的 Text Editor 事件：

OnEditorBlockChanged 事件

如果 Text Editor 觸發 OnEditorBlockChanged 事件，元件同步器會執行下列操作：

1. 如果 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer 屬性皆已設定，則會針對指定區塊呼叫 ImageViewer 和 ZoomViewer 物件的 SetSelectedBlocksIndices 方法。
2. 如果是表格區塊，則會針對所選儲存格呼叫 ImageViewer 和 ZoomViewer 物件的 SetSelectedCells 方法。
3. 接著會呼叫 ImageViewer 和 ZoomViewer 物件的 ShowDocumentArea 方法。

OnSymbolSelected 事件

如果 Text Editor 觸發 OnSymbolSelected 事件，元件同步器會執行下列操作：

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

OnActivePageChanged 事件

如果 Text Editor 觸發 OnActivePageChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、DocumentViewer 屬性都已設定，則對應元件的 FRPage 或 ActivePage 屬性會設為文件中指定的頁面。

OnOptionsChanged 事件

如果 Text Editor 觸發 OnOptionsChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、DocumentViewer、TextValidator 屬性都已設定，則會呼叫 ImageViewer、ZoomViewer、DocumentViewer、TextValidator 物件的 UpdateOptions 方法。

已連接的 Text Validator 事件：

OnSymbolSelected 事件

如果 Text Validator 觸發 OnSymbolSelected 事件，元件同步器會執行下列操作：

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

OnSelectionChanged 事件

如果 Text Validator 觸發 OnSelectionChanged 事件，元件同步器會執行下列操作：

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

OnActivePageChanged 事件

如果 Text Validator 觸發 OnActivePageChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、TextEditor、DocumentViewer 屬性都已設定，則對應元件的 FRPage 或 ActivePage 屬性會設為文件中指定的頁面。

OnDocumentChanged 事件

如果 Text Validator 觸發 OnDocumentChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、TextEditor、DocumentViewer 屬性都已設定：

• DocumentViewer 物件的 FRDocument 屬性會設為新文件
• ImageViewer、ZoomViewer 和 TextEditor 物件的 FRPage 屬性，以及 DocumentViewer 物件的 ActivePage 屬性，會設為新文件的第一頁。

OnOptionsChanged 事件

如果 Text Validator 觸發 OnOptionsChanged 事件，且 ComponentSynchronizer 物件的 ImageViewer、ZoomViewer、TextEditor、DocumentViewer 屬性都已設定，則會呼叫 ImageViewer、ZoomViewer、TextEditor、DocumentViewer 物件的 UpdateOptions 方法。

​

另請參閱

ComponentSynchronizer