메인 콘텐츠로 건너뛰기
Visual Components는 Windows용 FRE에서 구현됩니다.
DocumentViewer 객체는 문서의 페이지 목록을 보고 각 페이지의 상태를 모니터링할 수 있는 ActiveX 컨트롤입니다. 또한 구성 요소에서 제공하는 명령을 사용해 인식된 문서를 저장하거나 선택한 애플리케이션에서 열 수도 있습니다. 문서는 FRDocument 속성을 통해 구성 요소에 연결됩니다. 문서 뷰어 구성 요소는 Mode 속성 값에 따라 다음과 같이 표시될 수 있습니다.
  • 자세히 보기
각 문서 페이지에 대한 자세한 정보를 제공합니다. DocumentViewer_Details
  • 축소판 보기
문서 페이지를 축소판으로 표시합니다. DocumentViewer_Thumbnails 구성 요소의 모양은 속성을 통해 변경할 수 있습니다. 예를 들어 Toolbar 속성을 통해 도구 모음에 버튼을 추가하거나 제거할 수 있고, PopupMenu 속성을 통해 구성 요소의 바로 가기 메뉴를 수정할 수 있습니다. 자세한 내용은 Visual Component의 바로 가기 메뉴 및 도구 모음 사용자 지정을 참조하세요. 문서 모니터링 정보는 특수한 송신 인터페이스를 통해 전달됩니다. 이러한 인터페이스는 IDocumentViewerEvents(C++용)와 dispinterface DIDocumentViewerEvents(Visual Basic용)입니다. Visual Basic 사용자는 이 개발 플랫폼에서 이벤트 처리를 쉽게 지원하므로 이벤트 인터페이스 구현 세부 사항까지 신경 쓸 필요가 없다는 점에 유의해야 합니다. 이 객체는 Visual Basic에서 WithEvents로 선언할 수 있습니다. C++ 사용자의 경우 이는 이 객체가 IConnectionPointContainer 인터페이스를 지원한다는 의미입니다. 알림 이벤트를 받으려면 C++ 사용자는 IDocumentViewerEvents 인터페이스에서 파생된 객체를 만든 다음, 표준 COM 방식으로 해당 객체와 DocumentViewer 객체에 구현된 이벤트 소스 사이의 연결을 설정해야 합니다. 문서 뷰어 구성 요소는 Component Synchronizer 구성 요소에 연결할 수 있습니다. 이 경우 문서 뷰어의 모든 이벤트는 Synchronizer에 연결된 다른 구성 요소로 자동 전달되며, 전체 애플리케이션이 동기화된 상태로 작동합니다.

속성

Document Viewer의 활성 페이지를 지정합니다. 활성 페이지가 없으면 이 속성의 값은 0입니다.

Document Viewer의 캡션 창 사용 여부를 지정합니다. 이 속성이 FALSE이면 캡션 창이 표시되지 않습니다.

기본값은 TRUE입니다.

Document Viewer의 컨텍스트 메뉴 사용 여부를 지정합니다. 이 속성이 FALSE이면 컨텍스트 메뉴가 표시되지 않습니다.

기본값은 TRUE입니다.

,읽기 전용

Document Viewer에서 사용할 수 있는 명령에 액세스할 수 있습니다.Document Viewer에서 사용할 수 있는 명령 목록을 참조하세요.

Document Viewer에 연결된 문서를 지정합니다.

Document Viewer의 언어 페이지 사용 여부를 지정합니다. 이 속성이 FALSE이면 언어 페이지가 표시되지 않습니다.

기본값은 TRUE입니다.

Document Viewer가 잠겨 있는지 여부를 지정합니다.

이 속성은 다음과 같은 상황에서 유용합니다.

  • analysis, recognition, synthesis 또는 export 작업이 Visual Components가 아니라 FineReader Engine API에서 호출되는 경우, 또는
  • 애플리케이션이 특정 이벤트(예:객체로부터)에 대한 알림을 받고, 이러한 이벤트 처리기에서 Visual Components의 Windows 메시지를 처리하는 경우

이 경우 analysis, recognition, synthesis 또는 export를 수행하기 전에 이 속성을 TRUE로 설정하고, 작업이 끝난 후에는 FALSE로 설정하는 것이 좋습니다. 이렇게 하면 Document Viewer에서 문서가 손상되지 않습니다.

기본값은 FALSE입니다.

Document Viewer의 현재 모드(Details 보기 또는 Thumbnails 보기)를 지정합니다.

기본 모드는 DVM_Thumbnails입니다.

,읽기 전용

컨텍스트 메뉴 설정에 액세스할 수 있습니다.

문서의 기본 처리 매개변수를 지정합니다. 이러한 분석 및 인식 프로세스를 Document Viewer에서 직접 호출하는 경우 이러한 매개변수가 사용됩니다.

Document Viewer가 Component Synchronizer에 연결되어 있는 경우 처리에 사용되는 매개변수를 변경하려면IComponentSynchronizer::ProcessingParams속성을 사용합니다. Document Viewer의 속성을 통해 처리 매개변수를 변경하면 오류가 발생할 수 있습니다.

Document Viewer 구성 요소의 제목을 지정합니다.

기본값은 “Pages”입니다.

,읽기 전용

도구 모음 설정에 액세스합니다.

선택된 페이지 인덱스 컬렉션에 액세스합니다.

Document Viewer의 설정 파일이 들어 있는 폴더 경로를 지정합니다. 다른 Visual Component에도 동일한 속성이 있습니다. 각 Visual Component는 자체 설정 폴더를 사용해야 합니다.

이 속성의 값은 ABBYY FineReader Engine이 사용자별 데이터를 저장하는 폴더의 경로와 해당 하위 폴더 이름으로 구성됩니다. 기본적으로 사용자별 데이터가 저장되는 폴더는FineReader Engine data folder입니다. 이 값은 FineReader Engine 초기화 중에(함수 또는메서드를 통해) 변경할 수 있습니다. 하위 폴더의 기본 이름은 임의의 GUID입니다. 하위 폴더 이름을 변경하려면 디자인 타임에 Visual Studio의 구성 요소 속성에서 새 이름을 지정해야 합니다. 런타임에 이 속성 값을 지정하려고 하면 해당 값은 무시됩니다.

디자인 시 Visual Studio에서 이 구성 요소를 폼에 추가하면 속성 값은 기본값으로 자동 설정되거나 사용자 지정 값으로 수동 설정됩니다. 두 경우 모두 값은 디자인 타임에 정의됩니다. 어떤 이유로든 속성 값이 디자인 타임에 정의되지 않으면(예: 런타임에 구성 요소를 동적으로 생성하는 경우) 구성 요소가 초기화될 때마다 새 설정 폴더가 생성됩니다. 폴더가 계속 늘어나는 것을 방지하려면 구성 요소 초기화 해제 후 생성된 설정 폴더를 삭제해야 합니다. 이 경우 구성 요소의 기본 설정만 사용할 수 있으며 세션 간에 설정을 저장할 수 없습니다.

, 읽기 전용

클라이언트 영역의 창 핸들을 반환합니다.

메서드

이름설명
UpdateOptions문서 뷰어의 옵션 대화 상자에 지정된 설정을 업데이트합니다. 다른 Visual Component에서 옵션이 변경된 경우, 문서 뷰어의 옵션을 현재 상태에 맞게 업데이트하려면 이 메서드를 호출해야 할 수 있습니다.

샘플

이 구성 요소는 다음 코드 샘플에 사용됩니다: VisualComponents.

참고 항목

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer 그래픽 사용자 인터페이스를 사용하는 애플리케이션 만들기 Visual Component의 컨텍스트 메뉴 및 도구 모음 사용자 지정