次の方法で共有

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
 音声入力の 2 つのモードを切り替えます。ディクテーションとコマンド/コントロール (アプリケーションにコマンドを提供するか、メニューにアクセスします)。
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
 テレビやラジオのチューナなどのチャンネル値をデクリメントします。
APPCOMMAND_MEDIA_CHANNEL_UP
51
 テレビやラジオのチューナなどのチャンネル値をインクリメントします。
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
 再生または一時停止の再生。 個別の Play と Pause ボタンがある場合、アプリケーションはこのコマンドに対してアクションを実行し、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 コンポーネントは、さまざまな仮想キーがダウンしているかどうかを示し、次の値のうち 1 つ以上を指定できます。

価値 意味
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返す必要があります。 戻り値の処理の詳細については、「解説」セクションを参照してください。

備考

DefWindowProc 、WM_XBUTTONUP または WM_NCXBUTTONUP メッセージを処理するとき、またはユーザーがアプリケーション コマンド キーを入力したときに、WM_APPCOMMAND メッセージが生成されます。

子ウィンドウがこのメッセージを処理せず、代わりに DefWindowProc呼び出す場合、DefWindowProc は、その親ウィンドウにメッセージを送信します。 最上位ウィンドウがこのメッセージを処理せず、代わりに DefWindowProc呼び出す場合、DefWindowProc は、HSHELL_APPCOMMANDと等しいフック コードを持つシェル フックを呼び出します。

メッセージがマウス クリックによって生成された場合にカーソルの座標を取得するには、アプリケーションで GetMessagePos呼び出すことができます。 アプリケーションは、lParam に FAPPCOMMAND_MOUSEが含まれているかどうかを確認することで、マウスによってメッセージが生成されたかどうかをテスト 。

他のウィンドウ メッセージとは異なり、アプリケーションは処理 場合、このメッセージから TRUE を返す必要があります。 これにより、Windows 2000 より前の Windows システムでこのメッセージをシミュレートするソフトウェアは、ウィンドウ プロシージャがメッセージを処理したか、DefWindowProc 呼び出して処理するかを判断できます。

必要条件

要件 価値
サポートされる最小クライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小サーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダ
Winuser.h (Windows.h を含む)

関連項目

リファレンス

DefWindowProc の

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

概念

マウス入力 の