다음을 통해 공유

IImePad::Request 메서드(imepad.h)

  • 아티클

앱에 텍스트를 삽입하기 위해 IImePadApplet 에서 호출됩니다.

요청 은 IImePadApplet 에서 호출할 수 있는 유일한 방법입니다. iImePadApplet은 IMEPADREQ_* 요청 ID 중 하나를 사용하여 이 메서드를 호출하여 앱에 텍스트를 삽입하고 앱에서 IME의 컴퍼지션 문자열을 제어할 수 있습니다.

구문

HRESULT Request(
  [in]      IImePadApplet *pIImePadApplet,
  [in]      INT           reqId,
  [in, out] WPARAM        wParam,
  [in, out] LPARAM        lParam
);

매개 변수

[in] pIImePadApplet

호출하는 애플릿의 인터페이스 포인터입니다.

[in] reqId

요청 유형(요청 ID)입니다. 다음 값 중 하나로 설정해야 합니다.

값 의미
IMEPADREQ_INSERTSTRING
 앱에 문자열을 컴퍼지션 문자열로 삽입합니다.
  • wParam: 앱에 삽입할 NULL로 끝나는 문자열(LPWSTR)에 대한 포인터입니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_SENDCONTROL
 앱에서 문자열 및 caret의 컴퍼지션을 제어합니다.
  • wParam: IME가 컴퍼지션 문자열 및 캐리트 위치를 처리하도록 요청하는 컨트롤 값(IMEPADCTRL_*)을 지정합니다. IMEPADCTRL_* 값 목록은 주의 사항을 참조하세요.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_SETAPPLETSIZE
 새 애플릿 창 크기를 설정합니다.
  • wParam: LOWORD(wParam)는 애플릿의 너비를 지정합니다. HIWORD(wParam)는 애플릿의 높이를 지정합니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_GETCOMPOSITIONSTRING
 현재 컴퍼지션 문자열 텍스트를 가져옵니다.
  • wParam: 현재 컴퍼지션 문자열 텍스트를 수신하는 버퍼(LPWSTR)를 가리킵니다.
  • lParam: 종료 null 문자를 포함하여 복사할 최대 문자 수입니다.
IMEPADREQ_GETCOMPOSITIONSTRINGINFO
 현재 컴퍼지션 문자열에 대한 정보를 가져옵니다.
  • wParam: 컴퍼지션 정보를 수신하는 IMECOMPOSITIONSTRINGINFO 구조체에 대한 포인터입니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_DELETESTRING
 컴퍼지션 문자열을 삭제합니다.
  • wParam: LOWORD(wParam)는 삭제할 컴퍼지션 문자열의 시작 위치를 지정합니다. HIWORD(wParam)는 삭제할 컴퍼지션 문자열의 길이를 지정합니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_CHANGESTRING
 컴퍼지션 문자열의 일부를 바꿉다.
  • wParam: 대체 문자열(LPWSTR)에 대한 포인터입니다.
  • lParam: LOWORD(lParam)는 바꿀 컴퍼지션 문자열의 시작 위치를 지정합니다. HIWORD(lParam)는 바꿀 컴퍼지션 문자열의 길이를 지정합니다.
IMEPADREQ_GETAPPLHWND
 애플리케이션 창 핸들을 가져옵니다.
  • wParam: 애플리케이션 창 핸들을 받을 HWND 핸들 주소(HWND *)입니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_FORCEIMEPADWINDOWSHOW
 ImePad 창을 계속 표시합니다.
  • wParam: TRUE 이면 IMEPad 창이 계속 표시됩니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_POSTMODALNOTIFY
 IImePad가 특정 알림 ID 및 사용자 정의 데이터를 사용하여 애플릿의 Notify 메서드를 비동기적으로 호출하도록 합니다.
  • wParam: 알림 코드(IMEPN_*)입니다. 가능한 IMEPN_* 코드는 IImePadApplet::Notify에 대한 설명을 참조하세요.
  • lParam: 사용자 정의 데이터
IMEPADREQ_GETDEFAULTUILANGID
 권장되는(기본값) ImePad 애플릿 UI 언어를 가져옵니다.
  • wParam: 기본 UI 언어를 받을 언어 ID(LANGID *)의 주소입니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_GETCURRENTUILANG
 현재 ImePad 애플릿 UI 언어를 가져옵니다.
  • wParam: 현재 UI 언어를 받을 언어 ID(LANGID *)의 주소입니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_GETAPPLETUISTYLE
 애플릿의 UI 스타일(IPAWS_* 플래그)을 가져옵니다.
  • wParam: 애플릿 UI 스타일(DWORD *)을 받을 주소입니다. 스타일은 IPAWS_* 플래그의 조합입니다. 가능한 IPAWS_* 플래그는 설명을 참조하세요.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_SETAPPLETUISTYLE
 애플릿의 UI 스타일(IPAWS_* 플래그)을 설정합니다.
  • wParam: Applet UI 스타일입니다. 스타일은 IPAWS_* 플래그의 조합입니다. 가능한 IPAWS_* 플래그는 설명을 참조하세요.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_ISAPPLETACTIVE
 애플릿이 활성 상태인지 확인합니다.
  • wParam: 값을 받을 주소입니다(BOOL *). TRUE이면 애플릿이 활성화됩니다. 그렇지 않으면 애플릿이 활성화되지 않습니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_ISIMEPADWINDOWVISIBLE
 ImePad가 표시되는지 확인합니다.
  • wParam: 값을 받을 주소입니다(BOOL *). TRUE이면 ImePad가 표시됩니다. 그렇지 않으면 ImePad가 표시되지 않습니다.
  • lParam: 사용되지 않습니다. 0으로 설정해야 합니다.
IMEPADREQ_SETAPPLETMINMAXSIZE
 최소 및 최대 애플릿 크기를 설정합니다.
  • wParam: LOWORD(wParam)는 애플릿 너비를 지정합니다. HIWORD(wParam)는 애플릿 높이를 지정합니다.
  • lParam: TRUE 는 최대 크기를 설정합니다. FALSE - 최소 크기를 설정합니다.
IMEPADREQ_GETCONVERSIONSTATUS
 현재 애플리케이션 IME의 변환 상태 가져옵니다. 변환 및 문장 모드의 전체 목록은 헤더 파일 Imm.h를 참조하세요.
  • wParam: 변환 모드를 받을 주소(DWORD *).
  • lParam: 문장 모드를 받을 주소(DWORD *).
IMEPADREQ_GETVERSION
 IImePad의 버전 정보를 가져옵니다.
  • wParam: 주 버전을 받을 주소(DWORD *).
  • lParam: 부 버전을 받을 주소(DWORD *).
IMEPADREQ_GETCURRENTIMEINFO
 ImePad를 호출한 IME 정보를 가져옵니다.
  • wParam: IME의 언어 ID(DWORD *)를 받을 주소입니다.
  • lParam: IME의 입력 ID(DWORD *)를 받을 주소입니다.

[in, out] wParam

reqId와 관련된 추가 정보입니다.

[in, out] lParam

reqId와 관련된 추가 정보입니다.

반환 값

성공하면 S_OK 그렇지 않으면 E_FAIL.

설명

가능한 IMEPADCTRL_* 값

다음은 reqId가 IMEPADREQ_SENDCONTROL 설정되면 wParam에서 수행할 수 있는 가능한 값입니다.
Name 값 Description
IMEPADCTRL_CONVERTALL 1 모든 컴퍼지션 문자열을 변환합니다.
IMEPADCTRL_DETERMINALL 2 모든 컴퍼지션 문자열을 결정합니다.
IMEPADCTRL_DETERMINCHAR 3 지정된 개수의 컴퍼지션 문자열 문자를 결정합니다.
IMEPADCTRL_CLEARALL 4 모든 컴퍼지션 문자열을 지웁니다.
IMEPADCTRL_CARETLEFT 6 문자캐럿을 왼쪽으로 이동합니다.
IMEPADCTRL_CARETRIGHT 7 문자캐럿을 오른쪽으로 이동합니다.
IMEPADCTRL_CARETTOP 8 문자캐럿을 컴퍼지션 문자열의 맨 위로 이동합니다.
IMEPADCTRL_CARETBOTTOM 9 문자 캐리트를 컴퍼지션 문자열의 끝으로 이동합니다.
IMEPADCTRL_CARETBACKSPACE 10 캐리트 앞에 컴퍼지션 문자열의 문자를 삭제합니다(예: BACKSPACE 키).
IMEPADCTRL_CARETDELETE 11 캐리트 뒤에 있는 컴퍼지션 문자열의 문자를 삭제합니다(예: DELETE 키).
IMEPADCTRL_PHRASEDELETE 12 컴퍼지션 문자열의 구를 삭제합니다.
IMEPADCTRL_INSERTSPACE 13 IME 구성에 따라 전체 너비 또는 절반 너비의 공백 문자를 삽입합니다.
IMEPADCTRL_INSERTFULLSPACE 14 전체 너비 공간을 삽입합니다.
IMEPADCTRL_INSERTHALFSPACE 15 반자 간격을 삽입합니다.
IMEPADCTRL_ONIME 16 IME ON을 설정합니다.
IMEPADCTRL_OFFIME 17 IME OFF를 설정합니다.
IMEPADCTRL_ONPRECONVERSION 18 변환 전 ON을 설정합니다.
IMEPADCTRL_OFFPRECONVERSION 19 변환 전 OFF를 설정합니다.
IMEPADCTRL_PHONETICCANDIDATE 20 IME의 후보를 엽니다.
 

가능한 IPAWS_* 값

reqId가 IMEPADREQ_GETAPPLETUISTYLE 설정되거나 reqId가 IMEPADREQ_SETAPPLETUISTYLE 설정된 경우wParam을 로 설정할 수 있는 가능한 값입니다.
Name 설명
IPAWS_ENABLED 애플릿을 사용 가능한 창으로 표시합니다.
IPAWS_SIZINGNOTIFY IMEPN_SIZECHANGING 보내거나 IMEPN_SIZECHANGED 애플릿에 코드를 알립니다.
IPAWS_VERTICALFIXED 세로로 고정.
IPAWS_HORIZONTALFIXED 가로로 고정됩니다.
IPAWS_SIZEFIXED 크기가 고정되어 있습니다.
IPAWS_MAXWIDTHFIXED 최대 너비가 고정되어 있습니다.
IPAWS_MAXHEIGHTFIXED 최대 높이가 고정됩니다.
IPAWS_MAXSIZEFIXED 최대 크기가 고정되어 있습니다.
IPAWS_MINWIDTHFIXED 최소 너비가 고정되어 있습니다.
IPAWS_MINHEIGHTFIXED 최소 높이가 고정되어 있습니다.
IPAWS_MINSIZEFIXED 최소 크기가 수정되었습니다.

요구 사항

   
대상 플랫폼 Windows
헤더 imepad.h

참고 항목

IImePad

IImePadApplet

IMECOMPOSITIONSTRINGINFO