다음을 통해 공유


WM_SETHOTKEY 메시지

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

#define WM_SETHOTKEY                    0x0032

매개 변수

wParam

낮은 순서 단어의 낮은 바이트는 창과 연결할 가상 키 코드를 지정합니다.

낮은 순서 단어의 상위 바이트는 CommCtrl.h의 다음 값 중 하나 이상이 될 수 있습니다.

가치 의미
HOTKEYF_ALT
0x04
Alt 키
HOTKEYF_CONTROL
0x02
Ctrl 키
HOTKEYF_EXT
0x08
확장 키
HOTKEYF_SHIFT
0x01
SHIFT 키

wParam의 상위 단어는 무시됩니다.

wParamNULL로 설정하면 창과 연결된 핫 키가 제거됩니다.

lParam

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

반환 값

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

반환 값 설명
-1
함수가 실패했습니다. 핫 키가 잘못되었습니다.
0
함수가 실패했습니다. 창이 잘못되었습니다.
1
함수가 성공하고 다른 창에 동일한 핫 키가 없습니다.
2
함수가 성공했지만 다른 창에 이미 동일한 핫 키가 있습니다.

비고

핫 키는 자식 창에 연결할 수 없습니다.

VK_ESCAPE, VK_SPACE, VK_TABVK_PACKET 잘못된 핫 키입니다.

사용자가 핫 키를 누르면 시스템에서 wParam이 SC_HOTKEY 같고 lParam이 창의 핸들 과 같은 WM_SYSCOMMAND 메시지를 생성합니다. 이 메시지가 DefWindowProc에 전달되면 시스템에서 창의 마지막 활성 팝업(있는 경우) 또는 창 자체(팝업 창이 없는 경우)를 포그라운드로 가져옵니다.

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

이러한 핫 키는 RegisterHotKey에서 설정한 핫 키와 관련이 없습니다.

요구 사항

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

참고하십시오

참조

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

개념적인

키보드 입력