WM_CHAR メッセージ

WM_KEYDOWN メッセージが TranslateMessage 関数によって翻訳されるときに、キーボード フォーカスを使用してウィンドウに投稿されます。 WM_CHAR メッセージには、押されたキーの文字コードが含まれています。

#define WM_CHAR                         0x0102

パラメーター

wParam

キーの文字コード。

lParam

次の表に示すように、繰り返し数、スキャン コード、拡張キー フラグ、コンテキスト コード、前のキー状態フラグ、および遷移状態フラグ。

Bits	説明
0-15	現在のメッセージの繰り返し数。 値は、ユーザーがキーを押した結果としてキーストロークが自動レプリケートされる回数です。 キーストロークが十分に長く保持されている場合は、複数のメッセージが送信されます。 ただし、繰り返し数は累積されません。
16-23	スキャン コード。 値は OEM によって異なります。
24	キーが拡張キー (拡張 101 キーまたは 102 キー キーボードに表示される右側の Alt キーや Ctrl キーなど) であるかどうかを示します。 拡張キーの場合、値は 1 です。それ以外の場合は 0 です。
25-28	予約;は使用しないでください。
29	コンテキスト コード。 Alt キーを押しながらキーを押すと、値は 1 になります。それ以外の場合、値は 0 です。
30	以前のキーの状態。 メッセージが送信される前にキーがダウンしている場合は 1、キーが稼働している場合は 0 です。
31	遷移状態。 キーが解放されている場合は 1、キーが押されている場合は 0 です。

詳細については、「 キーストローク メッセージ フラグ」を参照してください。

戻り値

このメッセージを処理する場合、アプリケーションは 0 を返す必要があります。

例

LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {
   
    // ...

    case WM_CHAR:
        OnKeyPress(wParam);
        break;

    default:
        return DefWindowProc(hwnd, message, wParam, lParam);
    }
    return 0;
}

GitHub 上の Windows クラシック サンプルからの例。

解説

ウィンドウ クラスの登録に RegisterClass 関数の Unicode バージョンが使用されている場合、WM_CHAR メッセージは wParam で UTF-16 (16 ビット Unicode 変換形式) コード単位を使用します。 それ以外の場合、システムは現在のプロセス コード ページに文字を提供します。これは、Windows バージョン 1903 (2019 年 5 月の更新プログラム) 以降で UTF-8 に設定できます。 詳細については、「 ウィンドウ クラスの登録 」および「 Windows アプリで UTF-8 コード ページを使用する」を参照してください。

Windows Vista 以降では、 メッセージWM_CHARUTF-16 サロゲート ペアを Unicode ウィンドウに送信できます。 必要に 応じて、IS_HIGH_SURROGATE、 IS_LOW_SURROGATE、 IS_SURROGATE_PAIR マクロを使用して、このようなケースを検出します。

押されたキーと生成される文字メッセージの間には必ずしも一対一の対応があるとは限りません。そのため、 lParam パラメーターの上位ワードの情報は、通常、アプリケーションには役に立ちません。 上位の単語の情報は、WM_CHAR メッセージの投稿の前にある最新の WM_KEYDOWNメッセージにのみ 適用されます。

拡張 101 キーと 102 キーのキーボードの場合、拡張キーは、キーボードのメインセクションの右 Alt キーと右 Ctrl キーです。テンキーの左側にあるクラスターの INS、DEL、HOME、END、PAGE UP、PAGE DOWN キー、方向キー、およびテンキーの除算 (/) キーと ENTER キーです。 他の一部のキーボードでは、 lParam パラメーターで拡張キー ビットがサポートされている場合があります。

WM_UNICHAR メッセージは、UTF-32 を使用する点を除き、WM_CHARと同じです。 UNICODE 文字を ANSI ウィンドウに送信またはポストするように設計されており、Unicode 補助プレーン文字を処理できます。

必要条件

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

関連項目

• TranslateMessage
• Wm_keydown
• WM_UNICHAR
• キーボード入力
• キーボード入力の概要