키보드 가속기

아티클
03/12/2025

키보드 가속기(또는 간단히 액셀러레이터)는 애플리케이션에 대한 WM_COMMAND 또는 WM_SYSCOMMAND 메시지를 생성하는 키 입력 또는 키 입력의 조합입니다.

이 섹션에서

이름	묘사
키보드 가속기 대한	키보드 가속기에 대해 설명합니다.
키보드 가속기 사용하는	키보드 가속기와 연결된 작업에 대해 설명합니다.
키보드 가속기 참조	API 참조를 포함합니다.

키보드 가속기 함수

이름	묘사
copyAcceleratorTable	지정된 액셀러레이터 테이블을 복사합니다. 이 함수는 액셀러레이터 테이블 핸들에 해당하는 액셀러레이터 테이블 데이터를 가져오거나 액셀러레이터 테이블 데이터의 크기를 결정하는 데 사용됩니다.
createAcceleratorTable	액셀러레이터 테이블을 만듭니다.
DestroyAcceleratorTable	액셀러레이터 테이블을 삭제합니다.
LoadAccelerators	지정된 액셀러레이터 테이블을 로드합니다.
TranslateAccelerator	메뉴 명령에 대한 가속기 키를 처리합니다. 이 함수는 WM_KEYDOWN 또는 WM_SYSKEYDOWN 메시지를 WM_COMMAND 또는 WM_SYSCOMMAND 메시지(지정된 액셀러레이터 테이블에 키 항목이 있는 경우)로 변환한 다음 WM_COMMAND 또는 WM_SYSCOMMAND 메시지를 지정된 창 프로시저로 직접 보냅니다. TranslateAccelerator 창 프로시저가 메시지를 처리할 때까지 반환되지 않습니다.

키보드 가속기 메시지

이름	묘사
WM_CHANGEUISTATE	UI 상태를 변경해야 함을 나타내기 위해 전송됩니다.
WM_INITMENU	메뉴가 활성화될 때 전송됩니다. 사용자가 메뉴 모음에서 항목을 클릭하거나 메뉴 키를 누를 때 발생합니다. 이렇게 하면 애플리케이션이 표시되기 전에 메뉴를 수정할 수 있습니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다.
WM_QUERYUISTATE	창의 UI 상태를 검색하기 위해 전송됩니다.
WM_UPDATEUISTATE	지정된 창 및 모든 자식 창의 UI 상태를 변경하기 위해 전송됩니다.

키보드 가속기 알림

이름	묘사
WM_INITMENUPOPUP	드롭다운 메뉴 또는 하위 메뉴가 활성화될 때 전송됩니다. 이렇게 하면 애플리케이션이 전체 메뉴를 변경하지 않고 메뉴가 표시되기 전에 메뉴를 수정할 수 있습니다.
WM_MENUCHAR	메뉴가 활성화되어 있고 사용자가 니모닉 또는 액셀러레이터 키에 해당하지 않는 키를 누르면 전송됩니다. 이 메시지는 메뉴를 소유하는 창으로 전송됩니다.
WM_MENUSELECT	사용자가 메뉴 항목을 선택할 때 메뉴의 소유자 창으로 전송됩니다.
WM_SYSCHAR	WM_SYSKEYDOWN 메시지가 TranslateMessage 함수에 의해 번역될 때 키보드 포커스가 있는 창에 게시됩니다. 시스템 문자 키의 문자 코드( ALT 키가 다운된 동안 누른 문자 키)를 지정합니다.
WM_SYSCOMMAND	창은 사용자가 창 메뉴에서 명령을 선택하거나 사용자가 최대화 단추, 최소화 단추, 복원 단추 또는 닫기 단추를 선택할 때 이 메시지를 받습니다.

키보드 가속기 구조체

이름	묘사
ACCEL	액셀러레이터 테이블에 사용되는 액셀러레이터 키를 정의합니다.