메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt

Use this file to discover all available pages before exploring further.

Visual Components는 Windows용 FRE에 구현되어 있습니다.
Component Synchronizer는 Visual Components에서 발생하는 다양한 이벤트에 자동으로 반응하도록 구현된 특수 구성 요소입니다. 여러 Visual Components를 Synchronizer에 연결할 수 있으며, 이렇게 연결된 구성 요소들은 하나의 애플리케이션처럼 작동합니다. 모든 구성 요소를 연결한 상태로만 Component Synchronizer를 사용할 필요는 없으며, 실제로 사용하는 것만 연결하면 됩니다. 예를 들어, Image Viewer는 ImageViewer 속성을 통해, Text Editor는 TextEditor 속성을 통해 연결할 수 있습니다. Component Synchronizer에는 사용자 인터페이스가 없습니다. 또한 Visual Components의 내부 기능은 사용하지 않고, 구성 요소의 COM API만 사용합니다. Component Synchronizer는 아래에 설명된 방식으로 작동합니다.

​
API를 통해 구성 요소가 Synchronizer에 연결되는 경우

구성 요소 또는 객체가 다음 방식으로 Component Synchronizer에 연결되면:
이 경우 IComponentSynchronizer::ImageViewer 속성은 지정된 ImageViewer 객체로 설정되며, 이어서 다음 작업이 수행됩니다:
속성설정되는 값
True
IComponentSynchronizer::Document에서 IComponentSynchronizer::PageIndex 인덱스에 해당하는 페이지
이 경우 IComponentSynchronizer::ZoomViewer 속성은 지정된 ZoomViewer 객체로 설정되며, 이어서 다음 작업이 수행됩니다:
속성설정되는 값
True
IComponentSynchronizer::Document에서 IComponentSynchronizer::PageIndex 인덱스에 해당하는 페이지
이 경우 IComponentSynchronizer::TextEditor 속성은 지정된 TextEditor 객체로 설정되며, 이어서 다음 작업이 수행됩니다:
속성설정되는 값
IComponentSynchronizer::DocumentProcessingParams 객체의 SynthesisParamsForDocument 속성 값
IComponentSynchronizer::Document에서 IComponentSynchronizer::PageIndex 인덱스에 해당하는 페이지
이 경우 IComponentSynchronizer::TextValidator 속성은 지정된 TextValidator 객체로 설정되며, 이어서 다음 작업이 수행됩니다:
속성설정되는 값
IComponentSynchronizer::DocumentProcessingParams 객체의 SynthesisParamsForDocument 속성 값
이 경우 IComponentSynchronizer::DocumentViewer 속성은 지정된 DocumentViewer 객체로 설정되며, 이후 다음 작업이 수행됩니다.
속성설정 값
IComponentSynchronizer::Document에서 IComponentSynchronizer::PageIndex 인덱스에 해당하는 페이지
이 경우 IComponentSynchronizer::Document 속성은 지정된 FRDocument 객체로 설정되며, 이후 다음 작업이 수행됩니다.
속성설정 값



IComponentSynchronizer::Document의 첫 번째 페이지
0

이 경우 IComponentSynchronizer::DocumentProcessingParams 속성은 지정된 DocumentProcessingParams 객체로 설정되며, 이후 다음 작업이 수행됩니다.
속성설정 값



IComponentSynchronizer::DocumentProcessingParams 객체의 SynthesisParamsForDocument 속성 값
이 경우 IComponentSynchronizer::PageIndex 속성은 지정된 값으로 설정되며, 이후 다음 작업이 수행됩니다.
속성설정 값



IComponentSynchronizer::Document에서 IComponentSynchronizer::PageIndex 인덱스에 해당하는 페이지

​
연결된 구성 요소에서 이벤트가 발생할 때

연결된 Image Viewer의 이벤트:
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 );
}
Image Viewer에서 OnBlockSelectionChanged 이벤트가 발생하면 Component Synchronizer는 다음 작업을 수행합니다.
if( selected == VARIANT_TRUE ) {
 if( textEditor != 0 ) {
  textEditor->ShowBlock( blockIndex, NotFound );
 }
}
Image Viewer에서 OnTableCellsSelected 이벤트가 발생하면 Component Synchronizer는 선택된 블록 인덱스와 오른쪽 아래 셀 인덱스를 사용해 TextEditor 객체의 ShowBlock 메서드를 호출합니다.
Image Viewer에서 OnAfterDblClick 이벤트가 발생하면 Component Synchronizer는 다음 작업을 수행합니다.
if( textEditor != 0 ) {
 textEditor->ActivateOn( blockIndex, x, y );
}
Image Viewer에서 OnActivePageChanged 이벤트가 발생하고 ComponentSynchronizer 객체의 ZoomViewer, TextEditor, DocumentViewer Properties가 이미 설정되어 있으면, 해당 구성 요소의 FRPage 또는 ActivePage Property가 문서의 지정된 페이지로 설정됩니다.
Image Viewer에서 OnSelectTool 이벤트가 발생하면 Component Synchronizer는 다음 작업을 수행합니다.
if( ZoomViewer == 0 ) {
 return;
}
IFRPagePtr curPage;
ZoomViewer->get_FRPage( &curPage );
if( curPage != 0 ) {
 ZoomViewer->put_ActiveTool( selectedTool );
}
Image Viewer에서 OnOptionsChanged 이벤트가 발생하고 ComponentSynchronizer 객체의 ZoomViewer, DocumentViewer, TextEditor, TextValidator Properties가 이미 설정되어 있으면 ZoomViewer, DocumentViewer, TextEditor, TextValidator 객체의 UpdateOptions 메서드가 호출됩니다.
연결된 Zoom Viewer의 이벤트:
Zoom Viewer에서 OnVisibleDocumentAreaChange 이벤트가 발생하면 Component Synchronizer는 다음 작업을 수행합니다.
if( ImageViewer != 0 ) {
 ImageViewer->put_ZoomRect( visibleRect );
 if( isInFocus ) {
  ImageViewer->ShowDocumentArea( visibleRect );
 }
}
Zoom Viewer에서 OnBlockSelectionChanged 이벤트가 발생하면 Component Synchronizer는 다음 작업을 수행합니다.
if( selected == VARIANT_TRUE ) {
 if( textEditor != 0 ) {
  textEditor->ShowBlock( blockIndex, NotFound );
 }
}
Zoom Viewer에서 OnTableCellsSelected 이벤트가 발생하면 Component Synchronizer는 선택된 블록 인덱스와 오른쪽 아래 셀 인덱스를 사용해 TextEditor 객체의 ShowBlock 메서드를 호출합니다.
Zoom Viewer가 OnAfterDblClick 이벤트를 발생시키면 Component Synchronizer는 다음 작업을 수행합니다.
if( textEditor != 0 ) {
 textEditor->ActivateOn( blockIndex, x, y );
}
Zoom Viewer가 OnActivePageChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, TextEditor, DocumentViewer 속성이 이미 설정되어 있으면, 해당 구성 요소의 FRPage 또는 ActivePage 속성이 문서의 지정된 페이지로 설정됩니다.
Zoom Viewer가 OnSelectTool 이벤트를 발생시키면 Component Synchronizer는 다음 작업을 수행합니다.
if( ImageViewer == 0 ) {
 return;
}
IFRPagePtr curPage;
ImageViewer->get_FRPage( &curPage );
if( curPage != 0 ) {
 ImageViewer->put_ActiveTool( selectedTool );
}
Zoom Viewer가 OnOptionsChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, DocumentViewer, TextEditor, TextValidator 속성이 이미 설정되어 있으면, ImageViewer, DocumentViewer, TextEditor, TextValidator 객체의 UpdateOptions 메서드가 호출됩니다.
연결된 문서 뷰어의 이벤트:
문서 뷰어가 OnActivePageChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, TextEditor 속성이 이미 설정되어 있으면, 해당 구성 요소의 FRPage 속성이 문서의 지정된 페이지로 설정됩니다.
문서 뷰어가 OnDocumentChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, TextEditor, TextValidator 속성이 이미 설정되어 있으면 다음이 수행됩니다.
  • TextValidator 객체의 FRDocument 속성이 새 문서로 설정됩니다.
  • ImageViewer, ZoomViewer, TextEditor 객체의 FRPage 속성과 DocumentViewer 객체의 ActivePage 속성이 새 문서의 첫 번째 페이지로 설정됩니다.
문서 뷰어가 OnOptionsChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, TextEditor, TextValidator 속성이 이미 설정되어 있으면, ImageViewer, ZoomViewer, TextEditor, TextValidator 객체의 UpdateOptions 메서드가 호출됩니다.
연결된 Text Editor의 이벤트:
Text Editor가 OnEditorBlockChanged 이벤트를 발생시키면 ComponentSynchronizer는 다음 작업을 수행합니다.
  1. ComponentSynchronizer 객체의 ImageViewer, ZoomViewer 속성이 이미 설정되어 있으면, 지정된 블록에 대해 ImageViewer 및 ZoomViewer 객체의 SetSelectedBlocksIndices 메서드가 호출됩니다.
  2. 테이블 블록인 경우 선택된 셀에 대해 ImageViewer 및 ZoomViewer 객체의 SetSelectedCells 메서드가 호출됩니다.
  3. 그런 다음 ImageViewer 및 ZoomViewer 객체의 ShowDocumentArea 메서드가 호출됩니다.
Text Editor가 OnSymbolSelected 이벤트를 발생시키면 Component Synchronizer는 다음 작업을 수행합니다.
if( ZoomViewer != 0 ) {
 ZoomViewer->put_SymbolRect( symbolRect );
}
if( ImageViewer != 0 ) {
 ImageViewer->ShowDocumentArea( symbolRect );
}
if( ZoomViewer != 0 ) {
 ZoomViewer->ShowDocumentArea( symbolRect );
}
Text Editor가 OnActivePageChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, DocumentViewer 속성이 이미 설정되어 있으면, 해당 구성 요소의 FRPage 또는 ActivePage 속성이 문서의 지정된 페이지로 설정됩니다.
Text Editor가 OnOptionsChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, DocumentViewer, TextValidator 속성이 이미 설정되어 있으면, ImageViewer, ZoomViewer, DocumentViewer, TextValidator 객체의 UpdateOptions 메서드가 호출됩니다.
연결된 Text Validator의 이벤트:
Text Validator가 OnSymbolSelected 이벤트를 발생시키면, Component Synchronizer는 다음 작업을 수행합니다:
if( ZoomViewer != 0 ) {
 ZoomViewer->put_SymbolRect( symbolRectangle );
}
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 );
}
Text Validator가 OnActivePageChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, TextEditor, DocumentViewer 속성이 이미 설정되어 있으면, 해당 구성 요소의 FRPage 또는 ActivePage 속성이 문서의 지정된 페이지로 설정됩니다.
Text Validator가 OnDocumentChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, TextEditor, DocumentViewer 속성이 이미 설정되어 있으면:
  • DocumentViewer 객체의 FRDocument 속성이 새 문서로 설정됩니다
  • ImageViewer, ZoomViewer, TextEditor 객체의 FRPage 속성과 DocumentViewer 객체의 ActivePage 속성이 새 문서의 첫 번째 페이지로 설정됩니다.
Text Validator가 OnOptionsChanged 이벤트를 발생시키고 ComponentSynchronizer 객체의 ImageViewer, ZoomViewer, TextEditor, DocumentViewer 속성이 이미 설정되어 있으면, ImageViewer, ZoomViewer, TextEditor, DocumentViewer 객체의 UpdateOptions 메서드가 호출됩니다.

​
함께 보기

ComponentSynchronizer