SetInputScope 함수(inputscope.h)

지정된 창에 대한 입력 scope 설정합니다.

구문

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

[in] hwnd

scope 설정할 창입니다.

[in] inputscope

창과 연결할 입력 scope. 입력 scope 연결을 제거하려면 이 매개 변수에 IS_DEFAULT 전달합니다.

값	의미
S_OK	메서드를 성공적으로 수행했습니다.

이 메서드를 호출하면 창과 연결된 scope 바뀝니다.

애플리케이션은 이 메서드를 호출하여 hwnd 매개 변수에 IS_DEFAULT 전달하여 창이 제거되기 전에 입력 scope 연결을 제거해야 합니다.

이 API는 창(hwnd 매개 변수)과 호출 스레드가 동일한 스레드에 있는 경우에만 작동합니다. 다른 스레드 창에 대해 이 API를 호출하면 E_INVALIDARG 실패합니다.

문서 관리자와 연결되지 않은 창(hwnd 매개 변수)에서 이 메서드를 호출하는 경우 scope 변경에 응답할 수 있는 관심 있는 클라이언트(예: 터치 키보드)에 텍스트 서비스 알림이 전송되지 않습니다.

[C++]

다음 코드에서는 창에 대한 입력 scope 설정하는 방법을 보여 줍니다.


SetInputScope(hwnd, IS_EMAIL_USERNAME);