TranslateMessage

https://msdn.microsoft.com/ja-jp/library/ms644958.aspx https://msdn.microsoft.com/ja-jp/library/ms646280.aspx https://msdn.microsoft.com/ja-jp/library/ms646281.aspx https://msdn.microsoft.com/ja-jp/library/ms646276.aspx https://msdn.microsoft.com/ja-jp/library/ms646277.aspx https://msdn.microsoft.com/ja-jp/library/ms646286.aspx https://msdn.microsoft.com/ja-jp/library/ms646287.aspx https://msdn.microsoft.com/ja-jp/library/ms646357.aspx https://msdn.microsoft.com/ja-jp/library/ms646285.aspx https://msdn.microsoft.com/ja-jp/library/ms646276.aspx https://msdn.microsoft.com/ja-jp/library/ms646277.aspx https://msdn.microsoft.com/ja-jp/library/ms646280.aspx https://msdn.microsoft.com/ja-jp/library/ms646281.aspx https://msdn.microsoft.com/ja-jp/library/ms646357.aspx https://msdn.microsoft.com/ja-jp/library/ms646285.aspx https://msdn.microsoft.com/ja-jp/library/ms646286.aspx https://msdn.microsoft.com/ja-jp/library/ms646287.aspx

仮想キーメッセージを文字メッセージへ変換します。文字メッセージは、呼び出し側スレッドのメッセージキューにポストされ、次にそのスレッドが GetMessage または PeekMessage 関数を呼び出すと、その文字メッセージが読み取られます。

BOOL TranslateMessage(
  CONST MSG *lpMsg   // メッセージ情報
);

パラメータ

lpMsg
メッセージ情報を保持している、1 個の 構造体へのポインタを指定します。呼び出し側スレッドは、GetMessage または PeekMessage 関数を使って、自らのメッセージキューからこのメッセージ情報を取得します。

戻り値

メッセージが変換された場合(つまり、文字メッセージをスレッドのメッセージキューにポストした場合)、0 以外の値が返ります。

メッセージが、WM_KEYDOWNWM_KEYUPWM_SYSKEYDOWNWM_SYSKEYUP のいずれかであった場合、変換の有無にかかわりなく、0 以外の値が返ります。

メッセージが変換されなかった場合(つまり、文字メッセージをスレッドのメッセージキューにポストしなかった場合)、0 が返ります。

解説

TranslateMessage 関数は、lpMsg パラメータが指すメッセージに変更を加えません。

と の各メッセージの組み合わせは、 または メッセージを生成します。 と の各メッセージの組み合わせは、 または メッセージを生成します。

TranslateMessage 関数は、キーボードドライバが ASCII 文字を割り当てているキーに対してのみ、WM_CHAR メッセージを生成します。

アプリケーションが何か他の目的で仮想キーメッセージを処理する場合、TranslateMessage 関数を呼び出すべきではありません。たとえば、TranslateAccelerator 関数が 0 以外の値を返した場合(キーボードメッセージが変換された場合)、TranslateMessage 関数を呼び出すべきではありません。

対応情報

Windows NT/2000:Windows NT 3.1 以降
Windows 95/98:Windows 95 以降
ヘッダー:Winuser.h 内で宣言、Windows.h をインクルード
インポートライブラリ:User32.lib を使用

参照

GetMessage, PeekMessage, TranslateAccelerator, , , , , , , ,

表示: