다음을 통해 공유


ITfIntegratableCandidateListUIElement::OnKeyDown 메서드(ctffunc.h)

키 누름을 처리합니다.

구문

HRESULT OnKeyDown(
  [in]  WPARAM wParam,
  [in]  LPARAM lParam,
  [out] BOOL   *pfEaten
);

매개 변수

[in] wParam

키의 가상 키 코드를 지정합니다. 이 매개 변수에 대한 자세한 내용은 WM_KEYDOWNwParam 매개 변수를 참조하세요.

[in] lParam

키의 반복 수, 검사 코드, 확장 키 플래그, 컨텍스트 코드, 이전 키 상태 플래그 및 전환 상태 플래그를 지정합니다. 이 매개 변수에 대한 자세한 내용은 WM_KEYDOWNlParam 매개 변수를 참조하세요.

[out] pfEaten

키 이벤트가 처리된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

반환 값

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

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

설명

OnKeyDown 메서드를 사용하면 앱이 통합 스타일로 지정된 키를 처리하려는 경우 텍스트 서비스를 쿼리하도록 요청할 수 있습니다. OnKeyDown 메서드의 동작은 통합 스타일에 따라 달라질 수 있습니다. 텍스트 서비스가 *pfEaten=TRUE를 반환하는 경우 앱은 키를 처리하지 않아야 합니다. FALSE가 반환되면 앱은 키에 대한 응답으로 자체 작업을 수행할 수 있습니다.

GUID_INTEGRATIONSTYLE_SEARCHBOX ({E6D1BD11-82F7-4903-AE21-1A6397CDE2EB})을 사용하면 사용자가 인식된 키보드 포커스를 검색 상자에서 후보 목록으로 이동하여 제안을 검색할 수 있는 키보드 환경을 구현할 수 있습니다. 텍스트 서비스는 VK_UPVK_DOWN 같은 키를 처리한 후 Search에서 키를 처리하여 내부 상태를 변경할 수 있습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 ctffunc.h

추가 정보

ITfIntegratableCandidateListUIElement