WM_SETHOTKEY 메시지

  • 아티클

바로 가기 키를 창과 연결하기 위해 창에 전송됩니다. 사용자가 바로 가기 키를 누르면 시스템이 창을 활성화합니다.

#define WM_SETHOTKEY                    0x0032

매개 변수

wParam

하위 단어는 창과 연결할 가상 키 코드를 지정합니다.

상위 단어는 CommCtrl.h의 다음 값 중 하나 이상이 될 수 있습니다.

wParam을 NULL로 설정하면 창과 연결된 바로 가기 키가 제거됩니다.

값 의미
HOTKEYF_ALT
0x04
 Alt 키
HOTKEYF_CONTROL
0x02
 Ctrl 키
HOTKEYF_EXT
0x08
 확장 키
HOTKEYF_SHIFT
0x01
 Shift 키

lParam

이 매개 변수는 사용되지 않습니다.

반환 값

반환 값은 다음 중 하나입니다.

반환 값 Description
-1
 함수가 실패했습니다. 바로 가기 키가 잘못되었습니다.
0
 함수가 실패했습니다. 창이 잘못되었습니다.
1
 함수가 성공했으며 다른 창에 동일한 바로 가기 키가 없습니다.
2
 함수가 성공했지만 다른 창에 동일한 바로 가기 키가 이미 있습니다.

설명

바로 가기 키는 자식 창과 연결할 수 없습니다.

VK_ESCAPE, VK_SPACE 및 VK_TAB은 잘못된 바로 가기 키입니다.

사용자가 바로 가기 키를 누르면 시스템에서 wParam은 SC_HOTKEY와 동일하고 lParam은 창의 핸들과 동일한 WM_SYSCOMMAND 메시지를 생성합니다. 이 메시지가 DefWindowProc에 전달되면 시스템은 창의 마지막 활성 팝업(있는 경우)이나 창 자체(팝업 창이 없는 경우)를 전경으로 가져옵니다.

창에는 바로 가기 키가 하나만 있을 수 있습니다. 창에 연결된 바로 가기 키가 이미 있는 경우 새로운 바로 가기 키가 이전 바로 가기 키를 대체합니다. 둘 이상의 창에 동일한 바로 가기 키가 있는 경우 바로 가기 키로 활성화되는 창이 임의로 선택됩니다.

이 바로 가기 키는 RegisterHotKey에서 설정한 바로 가기 키와 관련이 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]
헤더
Winuser.h(Windows.h 포함)

추가 정보

참조

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

개념

키보드 입력