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

아티클
08/25/2023

잉크 입력에 사용할 InkRecognizerGuide 를 가져오거나 설정합니다.

이 속성은 읽기/쓰기가 가능합니다.

구문

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

매개 변수

RecognizerGuide

반환 값

없음

설명

Guide 속성 설정은 InkStrokes 컬렉션이 NULL인 경우에만 성공합니다. InkStrokes 컬렉션을 InkRecognizerContext에 연결하기 전에 Guide 속성을 설정해야 합니다. 또는 InkStrokes 컬렉션을 NULL로 설정한 다음 Guide(InkStrokes 컬렉션을 다시 연결할 수 있음)를 설정해야 합니다.

InkRecognizerCapabilities 열거형에는 IRC_FreeInput, IRC_LinedInput 및 IRC_BoxedInput 플래그가 포함됩니다. 이러한 플래그는 인식기의 기능을 지정하지만 읽기 전용이므로 IInkRecognizer 또는 InkRecognizerContext 개체에서 직접 설정할 방법이 없습니다. 특정 모드로 인식기를 배치하는 유일한 방법은 Guide 속성을 사용하여 가이드를 설정하는 것입니다. Guide 속성을 설정하지 않으면 인식기가 기본적으로 FreeInput 모드로 설정됩니다(인식기가 이 기능을 사용할 수 있는 경우). 인식기를 FreeInput 모드로 설정하는 또 다른 방법은 Guide 속성을 Columns 속성이 0으로 설정되고 Rows 속성이 0으로 설정된 InkRecognizerGuide 개체로 설정하는 것입니다.

Guide 속성을 Columns 속성이 0으로 설정되고 Rows 속성이 1 이상으로 설정된 InkRecognizerGuide 개체로 설정하면 인식기가 IRC_LinedInput 모드에 있습니다(인식기가 이를 지원하는 경우). 인식기에서 Rows 속성을 사용하여 줄 수를 제어합니다.

Guide 속성을 Rows 속성이 0으로 설정되고 Columns 속성이 1 이상으로 설정된 InkRecognizerGuide 개체로 설정하는 경우 인식기는 세로 쓰기를 위해 IRC_LinedInput 모드(인식기가 사용할 수 있는 경우)에 있습니다. 인식기에서 Columns 속성을 사용하여 세로선 수를 제어합니다. 인식기가 이 작업을 수행할 수 있는 경우 IInkRecognizer 개체의 Capabilities 속성은 IRC_DownAndLeft 또는 IRC_DownAndRight 반환하거나 둘 다 반환합니다.

Guide 속성을 Columns 속성이 1 이상으로 설정되고 Rows 속성이 1 이상으로 설정된 InkRecognizerGuide 개체로 설정하면 인식기가 IRC_BoxedInput 모드에 있습니다(인식기가 이를 지원하는 경우).

모드를 이 인식기에서 사용할 수 없는 모드로 설정하면 오류가 반환됩니다.

특정 인식기에서 사용할 수 있는 기능 또는 모드를 쿼리하는 방법에 대한 자세한 내용은 IInkRecognizer 개체의 Capabilities 속성을 참조하세요. 일반적으로 라틴어 스크립트의 인식기는 무료 입력 및 가로 줄 지어 입력을 지원하고, 동아시아 문자의 인식기는 무료 입력 및 박스 입력을 지원하며, 제스처 인식기는 무료 입력만 지원합니다.

요구 사항


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