WM_APPCOMMAND 메시지
예를 들어 마우스를 사용하여 애플리케이션 명령 단추를 클릭하거나 키보드에 애플리케이션 명령 키를 입력하여 사용자가 애플리케이션 명령 이벤트를 생성했음을 창에 알립니다.
#define WM_APPCOMMAND 0x0319
매개 변수
-
wParam
-
사용자가 단추를 클릭하거나 키를 누른 창에 대한 핸들입니다. 메시지를 수신하는 창의 자식 창일 수 있습니다. 이 메시지 처리에 대한 자세한 내용은 설명 섹션을 참조하세요.
-
lParam
-
다음 코드를 사용하여 lParam 매개 변수에 포함된 정보를 가져옵니다.
cmd = GET_APPCOMMAND_LPARAM(lParam); uDevice = GET_DEVICE_LPARAM(lParam); dwKeys = GET_KEYSTATE_LPARAM(lParam);애플리케이션 명령은 다음 값 중 하나일 수 있는 cmd
. 값 의미 - APPCOMMAND_BASS_BOOST
- 20
베이스 부스트를 켜고 끕니다. - APPCOMMAND_BASS_DOWN
- 19
저음을 줄입니다. - APPCOMMAND_BASS_UP
- 21
베이스를 늘입니다. - APPCOMMAND_BROWSER_BACKWARD
- 1
뒤로 이동합니다. - APPCOMMAND_BROWSER_FAVORITES
- 6
즐겨찾기를 엽니다. - APPCOMMAND_BROWSER_FORWARD
- 2
앞으로 이동합니다. - APPCOMMAND_BROWSER_HOME
- 7
홈으로 이동합니다. - APPCOMMAND_BROWSER_REFRESH
- 3
페이지를 새로 고칩니다. - APPCOMMAND_BROWSER_SEARCH
- 5
검색을 엽니다. - APPCOMMAND_BROWSER_STOP
- 4
다운로드를 중지합니다. - APPCOMMAND_CLOSE
- 31
응용 프로그램이 아닌 창을 닫습니다. - APPCOMMAND_COPY
- 36
선택 영역을 복사합니다. - APPCOMMAND_CORRECTION_LIST
- 45
음성 입력 중에 단어가 잘못 식별되면 수정 목록을 표시합니다. - APPCOMMAND_CUT
- 37
선택 영역을 잘라냅니다. - APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
- 43
받아쓰기 및 명령/제어(애플리케이션에 명령 제공 또는 메뉴 액세스)의 두 가지 음성 입력 모드 간에 전환합니다. - APPCOMMAND_FIND
- 28
찾기 대화 상자를 엽니다. - APPCOMMAND_FORWARD_MAIL
- 40
메일 메시지를 전달합니다. - APPCOMMAND_HELP
- 27
도움말 대화 상자를 엽니다. - APPCOMMAND_LAUNCH_APP1
- 17
App1을 시작합니다. - APPCOMMAND_LAUNCH_APP2
- 18
App2를 시작합니다. - APPCOMMAND_LAUNCH_MAIL
- 15
메일을 엽니다. - APPCOMMAND_LAUNCH_MEDIA_SELECT
- 16
미디어 선택 모드로 이동합니다. - APPCOMMAND_MEDIA_CHANNEL_DOWN
- 52
예를 들어 TV 또는 라디오 튜너의 경우 채널 값을 줄입니다. - APPCOMMAND_MEDIA_CHANNEL_UP
- 51
예를 들어 TV 또는 라디오 튜너의 경우 채널 값을 증분합니다. - APPCOMMAND_MEDIA_FAST_FORWARD
- 49
스트림 재생 속도를 높입니다. 예를 들어 고정 속도를 사용하거나 일련의 속도를 전환하여 여러 가지 방법으로 구현할 수 있습니다. - APPCOMMAND_MEDIA_NEXTTRACK
- 11
다음 트랙으로 이동합니다. - APPCOMMAND_MEDIA_PAUSE
- 47
일시 중지. 이미 일시 중지된 경우 추가 작업을 수행하지 않습니다. 상태가 없는 직접 PAUSE 명령입니다. 개별 재생 및 일시 중지 단추가 있는 경우 애플리케이션은 이 명령과 APPCOMMAND_MEDIA_PLAY_PAUSE작업을 수행해야 합니다. - APPCOMMAND_MEDIA_PLAY
- 46
현재 위치에서 재생을 시작합니다. 이미 일시 중지된 경우 다시 시작됩니다. 상태가 없는 직접 PLAY 명령입니다. 개별 재생일시 중지 단추가 있는 경우 애플리케이션은 이 명령과 APPCOMMAND_MEDIA_PLAY_PAUSE대해 작업을 수행해야 합니다. - APPCOMMAND_MEDIA_PLAY_PAUSE
- 14
재생을 재생하거나 일시 중지합니다. 개별 재생 일시 중지 단추가 있는 경우 애플리케이션은 APPCOMMAND_MEDIA_PLAY 및 APPCOMMAND_MEDIA_PAUSE뿐만 아니라 이 명령에 대한 작업을 수행해야 합니다. - APPCOMMAND_MEDIA_PREVIOUSTRACK
- 12
이전 트랙으로 이동합니다. - APPCOMMAND_MEDIA_RECORD
- 48
현재 스트림 녹음/녹화를 시작합니다. - APPCOMMAND_MEDIA_REWIND
- 50
더 빠른 속도로 스트림에서 뒤로 이동합니다. 예를 들어 고정 속도를 사용하거나 일련의 속도를 전환하여 여러 가지 방법으로 구현할 수 있습니다. - APPCOMMAND_MEDIA_STOP
- 13
재생을 중지합니다. - APPCOMMAND_MIC_ON_OFF_TOGGLE
- 44
마이크를 전환합니다. - APPCOMMAND_MICROPHONE_VOLUME_DOWN
- 25
마이크 볼륨을 줄입니다. - APPCOMMAND_MICROPHONE_VOLUME_MUTE
- 24
마이크를 음소거합니다. - APPCOMMAND_MICROPHONE_VOLUME_UP
- 26
마이크 볼륨을 늘입니다. - APPCOMMAND_NEW
- 29
새 창을 만듭니다. - APPCOMMAND_OPEN
- 30
창을 엽니다. - APPCOMMAND_PASTE
- 38
붙여넣기 - APPCOMMAND_PRINT
- 33
현재 문서를 인쇄합니다. - APPCOMMAND_REDO
- 35
마지막 작업을 다시 실행합니다. - APPCOMMAND_REPLY_TO_MAIL
- 39
메일 메시지에 회신합니다. - APPCOMMAND_SAVE
- 32
현재 문서를 저장합니다. - APPCOMMAND_SEND_MAIL
- 41
메일 메시지를 보냅니다. - APPCOMMAND_SPELL_CHECK
- 42
맞춤법 검사를 시작합니다. - APPCOMMAND_TREBLE_DOWN
- 22
고음을 줄입니다. - APPCOMMAND_TREBLE_UP
- 23
고음을 늘입니다. - APPCOMMAND_UNDO
- 34
마지막 작업을 실행 취소합니다. - APPCOMMAND_VOLUME_DOWN
- 9
볼륨을 낮춥다. - APPCOMMAND_VOLUME_MUTE
- 8
볼륨을 음소거합니다. - APPCOMMAND_VOLUME_UP
- 10
볼륨을 올립니다. uDevice 구성 요소는 입력 이벤트를 생성한 입력 디바이스를 나타내며 다음 값 중 하나일 수 있습니다.
값 의미 - FAPPCOMMAND_KEY
- 0
사용자가 키를 눌렀습니다. - FAPPCOMMAND_MOUSE
- 0x8000
사용자가 마우스 단추를 클릭했습니다. - FAPPCOMMAND_OEM
- 0x1000
확인되지 않은 하드웨어 원본이 이벤트를 생성했습니다. 마우스 또는 키보드 이벤트일 수 있습니다. dwKeys 구성 요소는 다양한 가상 키가 다운되었는지 여부를 나타내며 다음 값 중 하나 이상이 될 수 있습니다.
값 의미 - MK_CONTROL
- 0x0008
Ctrl 키가 다운되었습니다. - MK_LBUTTON
- 0x0001
마우스 왼쪽 단추가 아래쪽에 있습니다. - MK_MBUTTON
- 0x0010
마우스 가운데 단추가 아래쪽에 있습니다. - MK_RBUTTON
- 0x0002
마우스 오른쪽 단추가 아래쪽에 있습니다. - MK_SHIFT
- 0x0004
SHIFT 키가 다운되었습니다. - MK_XBUTTON1
- 0x0020
XBUTTON1 다운되었습니다. - MK_XBUTTON2
- 0x0040
XBUTTON2 다운되었습니다.
반환 값
애플리케이션이 이 메시지를 처리하는 경우 TRUE반환해야 합니다. 반환 값 처리에 대한 자세한 내용은 설명 섹션을 참조하세요.
발언
DefWindowProcWM_XBUTTONUP 또는 WM_NCXBUTTONUP 메시지를 처리하거나 사용자가 애플리케이션 명령 키를 형식화할 때 WM_APPCOMMAND 메시지를 생성합니다.
자식 창에서 이 메시지를 처리하지 않고 대신 DefWindowProc
마우스 클릭으로 메시지가 생성된 경우 커서의 좌표를 가져오기 위해 애플리케이션은 GetMessagePos호출할 수 있습니다. 애플리케이션은 lParamFAPPCOMMAND_MOUSE포함하는지 확인하여 메시지가 마우스에 의해 생성되었는지 여부를 테스트할 수 있습니다.
다른 Windows 메시지와 달리 애플리케이션은 처리할 경우 이 메시지에서 TRUE 반환해야 합니다. 이렇게 하면 Windows 2000 이전의 Windows 시스템에서 이 메시지를 시뮬레이트하는 소프트웨어가 창 프로시저가 메시지를 처리했는지 아니면 DefWindowProc 호출하여 처리할지를 결정할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows 2000 Server [데스크톱 앱만 해당] |
| 머리글 |
|