메인 콘텐츠로 건너뛰기
Visual Components는 Windows용 FRE에서 구현됩니다.
ImageViewer 객체는 이미지와 이미지 내 블록을 보고 편집할 수 있게 해 주는 ActiveX 컨트롤입니다. 이미지는 FRPage 속성을 통해 Image Viewer에 연결됩니다. Image Viewer 구성 요소는 다음과 같습니다. ImageViewer 구성 요소의 모양은 속성을 통해 변경할 수 있습니다. 예를 들어 Toolbar 속성을 통해 도구 모음에 버튼을 추가하거나 제거할 수 있고, PopupMenu 속성을 통해 구성 요소의 컨텍스트 메뉴를 수정할 수 있습니다. 자세한 내용은 Visual Component의 컨텍스트 메뉴 및 도구 모음 사용자 지정을 참조하세요. 이미지 보기 및 편집에 대한 정보는 특수한 출력 인터페이스를 통해 전달됩니다. 이러한 인터페이스는 IImageViewerEvents(C++용)와 dispinterface DIImageViewerEvents(Visual Basic용)입니다. Visual Basic 사용자는 이 개발 플랫폼에서 이벤트 인터페이스를 쉽게 처리할 수 있으므로, 이벤트 인터페이스 구현의 세부 사항까지 신경 쓸 필요가 없다는 점을 알아둘 필요가 있습니다. 이 객체는 Visual Basic에서 WithEvents로 선언할 수 있습니다. C++ 사용자의 경우 이는 이 객체가 IConnectionPointContainer 인터페이스를 지원한다는 의미입니다. 알림 이벤트를 받으려면 C++ 사용자는 IImageViewerEvents 인터페이스에서 파생된 객체를 만든 다음, 표준 COM 방식으로 그 객체와 ImageViewer 객체에 구현된 이벤트 소스 사이의 연결을 설정해야 합니다. Image Viewer 구성 요소는 Component Synchronizer 구성 요소에 연결할 수 있습니다. 이 경우 Image Viewer의 모든 이벤트가 Synchronizer에 연결된 다른 구성 요소에 자동으로 전달되어 전체 애플리케이션이 동기식으로 작동합니다.

속성

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

Image Viewer가 문서의 모든 페이지를 스크롤할지 여부를 지정합니다. 이 속성이 FALSE이면 Image Viewer는 선택한 페이지만 스크롤합니다.

기본값은 TRUE입니다.

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

기본값은 TRUE입니다.

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

기본값은 TRUE입니다.

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

기본값은 TRUE입니다.

,read-only

Image Viewer에서 사용 가능한 명령에 액세스할 수 있습니다.Image Viewer에서 사용 가능한 명령 목록을 참조하십시오.

Image Viewer에 연결된 문서 페이지를 지정합니다.

인식 중에 인식된 영역을 이미지에서 강조 표시할지 여부를 지정합니다. 이 속성을 사용하면 인식 진행 상황을 확인할 수 있습니다.

기본값은 TRUE입니다.

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

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

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

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

기본값은 FALSE입니다.

,read-only

컨텍스트 메뉴의 설정에 액세스합니다.

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

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

Image Editor 대화 상자에서 선택된 페이지의 인덱스 컬렉션에 액세스합니다.

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

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

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

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

기본값은 “Image”입니다.

,read-only

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

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

기본값은 ST_BestFit이며, 최적 맞춤이 자동으로 선택됩니다.

,read-only

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

, read-only

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

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

이미지에서 확대 영역을 점선 사각형으로 표시할지 여부를 지정합니다.

기본값은 TRUE입니다.

메서드

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

샘플

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

참고 항목

IImageViewerEvents IComponentSynchronizer::ImageViewer 그래픽 사용자 인터페이스 애플리케이션 만들기 Visual Component의 컨텍스트 메뉴 및 도구 모음 사용자 지정 속성 다루기