DispatchMessage 関数 (winuser.h)

ウィンドウ プロシージャにメッセージをディスパッチします。 通常、 GetMessage 関数によって取得されたメッセージをディスパッチするために使用されます。

構文

LRESULT DispatchMessage(
  [in] const MSG *lpMsg
);

パラメーター

[in] lpMsg

型: const MSG*

メッセージを含む構造体へのポインター。

戻り値

型: LRESULT

戻り値は、ウィンドウ プロシージャによって返される値を指定します。 その意味はディスパッチされるメッセージによって異なりますが、通常、戻り値は無視されます。

注釈

MSG 構造体には、有効なメッセージ値が含まれている必要があります。 lpmsg パラメーターが WM_TIMER メッセージを指していて、WM_TIMER メッセージの lParam パラメーターが NULL でない場合、lParam はウィンドウ プロシージャの代わりに呼び出される関数を指します。

アプリケーションは、ダイアログ ボックスへの入力メッセージの取得とディスパッチを担当することに注意してください。 ほとんどのアプリケーションでは、このためにメイン メッセージ ループが使用されます。 ただし、ユーザーがキーボードを使用してコントロールに移動したり、コントロールを選択したりできるようにするには、アプリケーションで IsDialogMessage を呼び出す必要があります。 詳細については、「 ダイアログ ボックス のキーボード インターフェイス」を参照してください。

例については、「 メッセージ ループの作成」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-message-l1-1-0 (Windows 8 で導入)

こちらもご覧ください

概念

GetMessage

IsDialogMessage

Msg

メッセージとメッセージ キュー

PeekMessage

リファレンス

TranslateMessage

Wm_timer