DLGPROC コールバック関数 (winuser.h)

関数の CreateDialog および DialogBox ファミリで使用されるアプリケーション定義のコールバック関数。 モーダル ダイアログ ボックスまたはモードレス ダイアログ ボックスに送信されたメッセージを処理します。 DLGPROC 型は、このコールバック関数へのポインターを定義します。 DialogProc は、アプリケーション定義関数名のプレースホルダーです。

構文

DLGPROC Dlgproc;

INT_PTR Dlgproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

パラメーター

unnamedParam1

型: HWND

ダイアログ ボックスを識別するハンドル。

unnamedParam2

型: UINT

メッセージ。

unnamedParam3

型: WPARAM

追加のメッセージ固有情報。

unnamedParam4

型: LPARAM

追加のメッセージ固有情報。

種類: INT_PTR

通常、ダイアログ ボックス プロシージャはメッセージを処理した場合 は TRUE を返し、処理しなかった場合は FALSE を 返す必要があります。 ダイアログ ボックス プロシージャが FALSE を返す場合、ダイアログ マネージャーはメッセージに応答して既定のダイアログ操作を実行します。

ダイアログ ボックス プロシージャが特定の戻り値を必要とするメッセージを処理する場合、ダイアログ ボックス プロシージャは TRUE を返す直前に SetWindowLong(hwndDlg, DWL_MSGRESULT, lResult) を呼び出して目的の戻り値を設定する必要があります。 TRUE を返す直前に SetWindowLong を呼び出す必要があることに注意 してください。このようにすると、入れ子になったダイアログ ボックス メッセージによって DWL_MSGRESULT 値が上書きされる可能性があります。

次のメッセージは、上記の一般的なルールの例外です。 戻り値のセマンティクスの詳細については、特定のメッセージのドキュメントを参照してください。

• WM_CHARTOITEM
• WM_COMPAREITEM
• WM_CTLCOLORBTN
• WM_CTLCOLORDLG
• WM_CTLCOLOREDIT
• WM_CTLCOLORLISTBOX
• WM_CTLCOLORSCROLLBAR
• WM_CTLCOLORSTATIC
• WM_INITDIALOG
• WM_QUERYDRAGICON
• WM_VKEYTOITEM

戻り値

なし

解説

ダイアログ ボックス のプロシージャは、ダイアログ ボックスのダイアログ ボックス クラスを使用する場合にのみ使用する必要があります。 これは既定のクラスであり、ダイアログ ボックス テンプレートで明示的なクラスが指定されていない場合に使用されます。 ダイアログ ボックス プロシージャはウィンドウ プロシージャに似ていますが、望ましくないメッセージを処理するために DefWindowProc 関数を呼び出してはなりません。 不要なメッセージは、ダイアログ ボックス ウィンドウ プロシージャによって内部的に処理されます。

要件

関連項目

概念

CreateDialog

CreateDialogIndirect

CreateDialogIndirectParam

CreateDialogParam

DefWindowProc

ダイアログ ボックス

ダイアログ

DialogBoxIndirect

DialogBoxIndirectParam

DialogBoxParam

リファレンス

SetFocus

WM_INITDIALOG