메인 콘텐츠로 건너뛰기
Visual Components는 Windows용 FRE에서 구현됩니다.
ZoomViewer 객체는 현재 편집 중인 줄이나 처리된 이미지 영역의 확대 이미지를 볼 수 있게 해 주는 ActiveX 컨트롤입니다. Image Viewer가 페이지의 전체 모습을 표시하는 반면, Zoom Viewer는 이미지를 더 자세히 확인하고, 영역 위치를 조정하거나, 확대 이미지와 함께 확실하지 않은 문자를 비교할 수 있는 편리한 방법을 제공합니다. 이미지는 FRPage 속성을 통해 Zoom Viewer에 연결됩니다. Zoom Viewer 구성 요소는 다음과 같습니다. ZoomViewer 구성 요소의 속성을 사용해 모양을 변경할 수 있습니다. 예를 들어 Commands 속성을 통해 구성 요소의 바로 가기 메뉴를 수정할 수 있습니다. 자세한 내용은 Visual Component의 바로 가기 메뉴 및 도구 모음 사용자 지정을 참조하세요. 이미지 보기 정보는 특수한 출력 인터페이스를 통해 전달됩니다. 이러한 인터페이스는 IZoomViewerEvents(C++용)와 dispinterface DIZoomViewerEvents(Visual Basic용)입니다. Visual Basic 사용자는 이 개발 플랫폼에서 이벤트 처리 수단을 쉽게 제공하므로 이벤트 인터페이스 구현 세부 사항까지 신경 쓸 필요가 없습니다. 이 객체는 Visual Basic에서 WithEvents로 선언할 수 있습니다. C++ 사용자의 경우 이는 이 객체가 IConnectionPointContainer 인터페이스를 지원한다는 의미입니다. 알림 이벤트를 받으려면 C++ 사용자는 IZoomViewerEvents 인터페이스에서 파생된 객체를 만든 다음, 표준 COM 방식을 사용해 해당 객체와 ZoomViewer 객체에 구현된 이벤트 소스 간의 연결을 설정해야 합니다. Zoom Viewer 구성 요소는 Component Synchronizer 구성 요소에 연결할 수 있습니다. 이 경우 Zoom Viewer의 모든 이벤트가 Synchronizer에 연결된 다른 구성 요소로 자동 전달되며, 전체 애플리케이션이 동기화된 상태로 작동합니다.

속성

블록 및 이미지 편집에 사용할 활성 도구를 지정합니다.

Zoom Viewer의 하단 창 활성화 여부를 지정합니다. 이 속성이 FALSE이면 하단 창이 표시되지 않습니다.

기본값은 TRUE입니다.

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

기본값은 TRUE입니다.

,read-only

Zoom Viewer에서 사용 가능한 명령에 대한 액세스를 제공합니다.Zoom Viewer에서 사용 가능한 명령 목록을 참조하십시오.

Zoom Viewer에 연결된 문서 페이지를 나타냅니다.

Zoom Viewer의 잠금 여부를 지정합니다.

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

  • 분석, 인식, 합성 또는 내보내기 작업이 Visual Components가 아닌 FineReader Engine API에서 호출되는 경우, 또는
  • 애플리케이션이 특정 이벤트 알림(예:객체로부터)을 수신하고, 해당 이벤트 핸들러에서 Visual Components의 Windows 메시지를 처리하는 경우.

이 경우, 분석, 인식, 합성 또는 내보내기 작업 전에 이 속성을 TRUE로 설정하고, 작업 완료 후 FALSE로 설정하는 것을 권장합니다. 이렇게 하면 Zoom Viewer에서 문서가 손상되는 것을 방지할 수 있습니다.

기본값은 FALSE입니다.

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

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

Zoom Viewer의 설정 파일이 포함된 폴더 경로를 지정합니다. 다른 Visual Components도 동일한 속성을 가집니다. 각 Visual Component는 자체 설정 폴더를 사용해야 합니다.

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

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

현재 문자 사각형의 좌표를 픽셀 단위로 저장합니다. 좌표는 문서 이미지를 기준으로 합니다.

현재 문자를 노란색 사각형으로 표시할지 여부를 지정합니다.

기본값은 TRUE입니다.

이미지의 배율을 백분율로 지정합니다. 이 속성은상수 중 하나로 설정할 수도 있습니다.

기본값은 ST_PixelToPixel이며, 이미지가 픽셀 대 픽셀 모드로 표시됩니다.

,read-only

표시 영역의 좌표를 픽셀 단위로 저장합니다. 좌표는 문서 이미지를 기준으로 합니다.

, 읽기 전용

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

메서드

이름설명
CenterOnDocumentPoint지정된 포인트가 보기의 중앙에 오도록 확대 보기를 스크롤합니다.
DocumentToScreen문서 이미지에서 지정된 포인트의 좌표를 화면 좌표로 변환합니다.
GetSelectedBlocksIndices선택된 블록 인덱스의 컬렉션을 반환합니다.
GetSelectedCells지정된 테이블 블록에서 선택된 셀을 둘러싸는 사각형을 반환합니다.
ScreenToDocument지정된 포인트의 화면 좌표를 문서 이미지의 좌표로 변환합니다.
SetSelectedBlocksIndices블록 선택을 설정합니다.
SetSelectedCells지정된 테이블 블록에서 선택할 셀을 설정합니다.
ShowDocumentArea지정된 좌표의 문서 영역이 보이도록 확대 보기를 스크롤합니다(가능한 범위 내에서).
UpdateOptionsZoom Viewer의 옵션 대화 상자에서 지정한 설정을 업데이트합니다. 다른 Visual Component에서 옵션이 변경된 경우, Zoom Viewer의 옵션을 현재 상태로 갱신하려면 이 메서드를 호출해야 할 수 있습니다.

샘플

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

참고 항목

IZoomViewerEvents IComponentSynchronizer::ZoomViewer 그래픽 사용자 인터페이스를 사용한 애플리케이션 만들기 Visual Component의 바로 가기 메뉴 및 도구 모음 사용자 지정