hozugawa.net · A neutral informational page

TranslateMessageとDispatchMessageでメッセージを変換・ディスパッチする

Windowsアプリケーションは、ユーザー操作やシステム通知をメッセージとして受け取り、メッセージループを通じて処理します。キーボード入力では、仮想キーを文字入力へ変換する処理と、各ウィンドウへメッセージを届ける処理を分けて考えることが重要です。

TranslateMessageとDispatchMessageは、標準的なメッセージループを構成する代表的なWin32 APIです。両者は似た位置で呼び出されますが、実行する仕事は異なります。変換と配送の境界を理解すると、WM_KEYDOWN、WM_CHAR、WM_COMMANDなどの流れを正しく追跡できます。

メッセージループの基本構造

通常のGUIスレッドでは、GetMessageでキューからメッセージを取り出し、TranslateMessageを経由してDispatchMessageを呼び出します。基本形は次のようになります。

MSG msg{};

while (GetMessage(&msg, nullptr, 0, 0) > 0) {
    TranslateMessage(&msg);
    DispatchMessage(&msg);
}

GetMessageは、処理対象のメッセージが届くまで待機します。戻り値が0ならWM_QUITを受け取った状態で、負の値ならエラーです。したがって、ループ条件を単純な真偽値ではなく> 0で記述すると、終了とエラーを区別できます。

メッセージループにネットワーク処理を組み合わせる場合は、ソケットの準備や非同期通知も設計対象になります。GUIスレッドを長時間ブロックさせない考え方は、ソケット準備の手順を確認するときにも共通します。

TranslateMessageが行う入力変換

TranslateMessageは、キーボードメッセージを文字メッセージへ変換する補助関数です。主にWM_KEYDOWNまたはWM_SYSKEYDOWNを調べ、文字入力に対応する場合は、同じスレッドのメッセージキューへWM_CHARまたはWM_SYSCHARを生成します。

この関数は、元のMSG構造体を書き換えて文字へ変換するわけではありません。変換可能なキー入力に対して、後続の文字メッセージをキューへ追加するだけです。そのため、TranslateMessageの戻り値を見て文字コードを取得することはできません。実際の文字は、ウィンドウプロシージャが受け取るWM_CHARのwParamから読み取ります。

キーボードレイアウト、現在の入力状態、デッドキーなどの影響を受ける点にも注意が必要です。物理キーの位置を知りたい処理ではWM_KEYDOWNやスキャンコードを使い、入力された文字を扱いたい処理ではWM_CHARを使うという切り分けが基本になります。

DispatchMessageとウィンドウプロシージャ

DispatchMessageは、MSGに含まれるhwndを手掛かりにして、対象ウィンドウのウィンドウプロシージャへメッセージを配送します。登録時に指定したコールバック関数へ処理が渡り、通常はWndProc内のswitch文でメッセージを判定します。

LRESULT CALLBACK WndProc(
    HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message) {
    case WM_CHAR:
        // 入力文字を処理する
        return 0;

    case WM_DESTROY:
        PostQuitMessage(0);
        return 0;
    }

    return DefWindowProc(hwnd, message, wParam, lParam);
}

処理しないメッセージは、原則としてDefWindowProcへ渡します。既定処理を省略すると、ウィンドウの移動、描画、閉じる操作など、標準動作が失われる場合があります。DispatchMessage自体は、アプリケーションのビジネスロジックを実行する関数ではなく、宛先を決めてコールバックを呼ぶ役割です。

二つのAPIの役割を比較する

TranslateMessageとDispatchMessageを同じ「入力処理API」と考えると、デバッグ時に混乱しやすくなります。前者はキーボード入力の補助的な変換、後者はメッセージの配送です。

API 主な対象 実行する処理 ウィンドウプロシージャとの関係
TranslateMessage WM_KEYDOWNなど 文字メッセージを生成 直接呼び出さない
DispatchMessage MSG全般 対象ウィンドウへ配送 WndProcを呼び出す
GetMessage メッセージキュー メッセージを取得・待機 取得だけを担当
PeekMessage メッセージキュー 待機せず取得 ゲームループなどで利用

たとえば、キーボードの矢印キーを移動操作として扱うなら、WM_KEYDOWNを処理すれば十分です。テキスト入力欄へ文字を表示するなら、TranslateMessageによって生成されたWM_CHARを利用します。

WebViewやブラウザ領域へ入力を渡す設計では、アプリケーション側の文字処理と表示先のイベント処理を混同しないことが大切です。外部ページを表示する動作を確認するケースでは、外部ページの検証例のように、表示処理と入力処理を別の観点から確認できます。

キーボード入力を扱う実装上の要点

WM_KEYDOWNのwParamには仮想キーコードが入り、lParamにはリピート回数や拡張キーなどのビット情報が含まれます。一方、WM_CHARのwParamには文字コードが入るため、目的に応じて参照するメッセージを選びます。

入力処理を実装するときは、次の点を先に決めておくとコードが安定します。

アクセラレータを使う場合は、通常のTranslateMessageより前にTranslateAcceleratorを呼び出す構成が一般的です。アクセラレータとして処理されたメッセージについては、通常の変換や配送を重ねて実行しないよう、戻り値を確認して分岐します。

ダイアログボックスではIsDialogMessageがキーボード操作を先に処理することがあります。タブ移動や既定ボタンの処理が必要な場合、すべてのメッセージを無条件に通常のウィンドウループへ渡すと、ダイアログ固有の操作が崩れる可能性があります。

メッセージ処理で起きやすい問題

文字が入力されない場合、最初に確認すべきなのはTranslateMessageを呼んでいるかどうかです。ただし、呼び出していても、WndProc側でWM_CHARを処理していなければ画面には何も表示されません。メッセージスパイやデバッガで、キューとウィンドウプロシージャの両方を確認します。

典型的な問題は次のように整理できます。

IMEによる日本語入力では、WM_IME_*メッセージやコンポジション処理が関係します。単純な英数字入力の確認だけで動作を判断すると、変換中の文字列や確定文字列を正しく扱えない場合があります。

また、TranslateMessageを複数回呼んでも、同じ文字が必ず複数生成されるとは限りませんが、意図しないメッセージ処理を組み込む原因になります。標準ループでは一つの取得メッセージに対して一度だけ呼ぶ構成を保つのが安全です。

実行順序をデバッグで確認する

メッセージ処理の不具合は、APIの名前よりも実行順序を確認すると原因を特定しやすくなります。まずGetMessageが何を取得したかを記録し、次にTranslateMessageの対象がキーボードメッセージか、最後にWndProcへ何が届いたかを追跡します。

WM_CHARが届かない場合は、キーボードフォーカスが目的のウィンドウにあるか、別のコントロールやダイアログが入力を処理していないかも確認します。DispatchMessageは、フォーカス中のコントロールへ自動的に文字を配る関数ではなく、MSG.hwndに記録された宛先へ配送する関数です。

Unicode対応のアプリケーションでは、RegisterClassW、CreateWindowExW、DefWindowProcWなど、使用する文字セットを揃えることも重要です。Windows APIの各関数を調べる際は、Windows API資料で宣言、引数、戻り値、関連メッセージを並べて確認すると、ANSI版とUnicode版の混在を避けやすくなります。

まず最小のウィンドウを作成し、GetMessage、TranslateMessage、DispatchMessageの直後とWndProc内にログを追加して、WM_KEYDOWNからWM_CHARまでの実際の流れを一度記録してください。