IInkRecognizerContext::BackgroundRecognize 메서드(msinkaut.h)

IInkRecognizer 개체가 연결된 스트로크 컬렉션을 인식하고 인식이 완료되면 Recognition 이벤트를 발생하도록 합니다.

구문

HRESULT BackgroundRecognize(
  [in, optional] VARIANT CustomData
);

매개 변수

[in, optional] CustomData

Recognition 이벤트에서 애플리케이션에 사용할 수 있는 애플리케이션 정의 데이터를 지정합니다. 이 매개 변수는 VT_EMPTY 형식의 VARIANT이거나 데이터를 전달할 필요가 없는 경우 VT_NULL 수 있습니다. 기본값은 NULL입니다.

VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
성공.
E_OUTOFMEMORY
작업을 완료하기 위해 메모리를 할당할 수 없습니다.
E_INK_NO_STROKES_TO_RECOGNIZE
스트로크가 없습니다.
E_INK_EXCEPTION
메서드 내에서 예외가 발생했습니다.

설명

이 메서드는 잉크 인식이 비동기적으로 수행되도록 지정합니다. 잉크를 동기적으로 인식하려면 Recognize 메서드를 호출합니다.

이 메서드는 최상의 결과 문자열만 인식합니다. 대체 항목이 만들어지지 않습니다. 사용 가능한 대체 목록을 만드는 인식을 수행하려면 BackgroundRecognizeWithAlternates 메서드를 호출합니다.

인식기가 아무것도 인식하지 못하는 경우 인식 이벤트가 발생하지 않습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 msinkaut.h
라이브러리 InkObj.dll

추가 정보

BackgroundRecognizeWithAlternates 메서드

Data 속성

IInkRecognitionAlternate 인터페이스

IInkRecognizerContext

InkRecognizerContext 클래스