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

속성

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

기본값은 TRUE입니다.

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

기본값은 TRUE입니다.

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

기본값은 TRUE입니다.

,read-only

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

페이지에서 커서 위치를 지정합니다.

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

Text Editor에서 텍스트 및 배경 색상을 유지할지 여부를 지정합니다.

이 속성의 기본값은 TRUE입니다.

Text Editor의 잠금 여부를 지정합니다.

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

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

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

기본값은 FALSE입니다.

문서 보기 모드 중 하나를 지정합니다.

기본값은 TEM_ExactCopy입니다.

,read-only

컨텍스트 메뉴의 설정에 대한 액세스를 제공합니다.

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

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

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

Text Editor에서 그림을 표시할지 여부를 지정합니다.

기본적으로 이 속성의 값은 TRUE입니다.

Text Editor에서 반복 제목을 표시할지 여부를 지정합니다.

기본적으로 이 속성의 값은 TRUE입니다.

문서의 기본 합성 매개변수를 지정합니다. 이 매개변수는 Text Editor가 문서 합성을 수행해야 할 때 사용되며, 일부 편집 작업으로 인해 문서의 논리적 구조가 올바르지 않게 된 경우 발생할 수 있습니다.

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

,읽기 전용

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

Text Editor 구성 요소의 제목을 지정합니다.

기본값은 “Text”입니다.

,읽기 전용

도구 모음 설정에 대한 액세스를 제공합니다.

텍스트 페이지의 배율을 백분율 단위로 지정합니다. 이 속성은상수 중 하나로 설정할 수도 있습니다.

기본값은 ST_BestFit이며, 이는 최적의 맞춤이 자동으로 선택됨을 의미합니다.

,read-only

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

, 읽기 전용

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

메서드

이름설명
ActivateOn지정된 블록 내 위치를 활성화하고 화면에 표시되도록 이동합니다.
CenterOnDocumentPoint지정된 문서 지점이 보기의 중앙에 오도록 텍스트 보기를 스크롤합니다.
DocumentToScreen문서 이미지에서 지정된 지점의 좌표를 화면 좌표로 변환합니다.
GetSelection선택 영역의 시작 및 끝 커서 위치를 반환합니다.
Print인식된 텍스트를 인쇄합니다.
SetSelection페이지에서 텍스트 선택 영역을 설정합니다.
ScreenToDocument지정된 지점의 화면 좌표를 문서 이미지 좌표로 변환합니다.
ShowBlock지정된 블록이 화면에 표시되도록 이동합니다(가능한 범위 내에서). 이 메서드는 Text Editor를 TEM_ExactCopy 모드로 사용할 때만 의미가 있습니다.
ShowDocumentArea지정된 좌표의 문서 영역이 표시되도록 텍스트 보기를 스크롤합니다(가능한 범위 내에서).
UpdateOptionsText Editor의 옵션 대화 상자에서 지정한 설정을 업데이트합니다. 다른 Visual Component에서 옵션이 변경된 경우, Text Editor의 옵션을 현재 상태로 갱신하려면 이 메서드를 호출해야 할 수 있습니다.

샘플

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

참고 항목

ITextEditorEvents IComponentSynchronizer::TextEditor 그래픽 사용자 인터페이스 애플리케이션 만들기 시각적 구성 요소의 컨텍스트 메뉴와 도구 모음 사용자 지정