메인 콘텐츠로 건너뛰기
Visual Components는 Windows용 FRE에 구현되어 있습니다.
TextValidator 객체는 문서에서 불확실하게 인식된 문자를 확인할 수 있게 해 주는 ActiveX 컨트롤입니다. 문서는 FRDocument 속성을 통해 이 구성 요소에 연결됩니다. Text Validator 구성 요소는 다음과 같이 표시될 수 있습니다. TextValidator 세로 쓰기 방향의 텍스트의 경우:
TextValidator_CJK
맞춤법 검사를 시작하려면 TextValidator 객체의 Spell 또는 SpellBlock 메서드 중 하나를 호출해야 합니다. 맞춤법 검사가 이미 진행 중이라면 먼저 중지해야 하며, 그렇지 않으면 이 메서드에 대한 새 호출은 무시됩니다.
  • Text Editor의 Check Spelling 버튼을 사용해 맞춤법 검사를 시작할 수도 있습니다.
  • 복합 문자 체계 언어(예: 중국어, 태국어, 아르메니아어)의 일부 문자는 Text Validator에서 사용하는 글꼴에 해당 문자가 포함되어 있지 않으면 Text Validator에 표시되지 않을 수 있습니다. 이 경우 Options 대화 상자에서 다른 글꼴을 지정할 수 있습니다(Text Validator에서 Settings > Options를 클릭하고, View 탭으로 이동한 다음, Font used to display plain text 드롭다운 목록에서 글꼴을 선택).
맞춤법 검사 정보는 특수한 출력 인터페이스를 통해 전달됩니다. 이러한 인터페이스는 ITextValidatorEvents(C++용)와 dispinterface인 DITextValidatorEvents(Visual Basic용)입니다. Visual Basic 사용자는 이 개발 플랫폼에서 이벤트 처리를 쉽게 지원하므로 이벤트 인터페이스 구현 세부 사항에 신경 쓸 필요가 없다는 점에 유의해야 합니다. 이 객체는 Visual Basic에서 WithEvents로 선언할 수 있습니다. C++ 사용자의 경우 이는 IConnectionPointContainer 인터페이스를 지원한다는 의미입니다. 알림 이벤트를 받으려면 ITextValidatorEvents 인터페이스에서 파생된 객체를 만든 다음, 표준 COM 방식을 사용하여 해당 객체와 TextValidator 객체에 구현된 이벤트 소스 사이의 연결을 설정해야 합니다. Text Validator 구성 요소는 Component Synchronizer 구성 요소에 연결할 수 있으며, 이 경우 Text Validator의 모든 이벤트가 Synchronizer에 연결된 다른 구성 요소로 자동 전달되어 전체 애플리케이션이 동기식으로 작동합니다.

속성

,read-only

맞춤법 검사 중 사용자가 사전에 추가한 단어 컬렉션을 나타냅니다.

맞춤법 검사 중 사전에 단어가 추가되면, 사용자 사전은ILanguageDatabase::DictionaryExtensionsPath속성으로 지정된 폴더에 생성됩니다.

단어 쌍의 컬렉션을 나타냅니다. 쌍의 첫 번째 단어는 맞춤법 검사 중 자동으로 교체되는 원본 단어이며, 두 번째 단어는 대체어입니다.

맞춤법 검사 중 Text Validator가 공백을 수정할지 여부를 지정합니다. 이 속성 값을 TRUE로 설정하면 Text Validator가 구두점 앞뒤의 공백을 수정합니다.

기본값은 FALSE입니다.

맞춤법 검사 중 무시할 단어 컬렉션을 나타냅니다.

, 읽기 전용

맞춤법 검사가 진행 중인지 여부를 나타냅니다.

Text Validator에 연결된 문서를 나타냅니다.

Text Validator가 잠겨 있는지 여부를 나타냅니다.

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

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

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

기본값은 FALSE입니다.

단어 쌍의 컬렉션을 나타냅니다. 쌍의 첫 번째 단어는 맞춤법 검사 중 교체되는 원본 단어이며, 두 번째 단어는 대체어입니다.

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

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

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

맞춤법 검사 중 Text Validator가 복합어에서 중지할지 여부를 지정합니다.

기본값은 FALSE입니다.

맞춤법 검사 중 Text Validator가 가비지에서 중지할지 여부를 지정합니다. 가비지는 의미 없는 문자 조합입니다.

기본값은 FALSE입니다.

맞춤법 검사 중 사전에 없는 단어에서 Text Validator가 중지할지 여부를 지정합니다. 이 속성과 StopAtUncertain 속성은 동시에 FALSE로 설정할 수 없습니다.

기본값은 TRUE입니다.

맞춤법 검사 중 불확실하게 인식된 문자에서 Text Validator가 중지할지 여부를 지정합니다. 이 속성과 StopAtNonDictionary 속성은 동시에 FALSE로 설정할 수 없습니다.

기본값은 TRUE입니다.

,읽기 전용

맞춤법 검사 중 불확실하게 인식된 단어의 맞춤법 교정을 위해 제안된 단어 컬렉션을 나타냅니다.

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

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

,읽기 전용

불확실한 문자 또는 단어의 위치를 나타냅니다.

, 읽기 전용

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

메서드

이름설명
EndSpelling맞춤법 검사를 중지합니다.
Spell지정한 위치에서 맞춤법 검사를 시작합니다.
SpellBlock지정한 블록의 맞춤법을 검사합니다.
UpdateOptionsText Validator의 Options 대화 상자에 지정된 설정을 업데이트합니다. 다른 Visual Component에서 옵션이 변경된 경우, 현재 상태를 반영하도록 이 메서드를 호출해야 할 수 있습니다.

샘플

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

참고 항목

ITextValidatorEvents IComponentSynchronizer::TextValidator 그래픽 사용자 인터페이스(GUI)를 사용하는 애플리케이션 만들기