CSimpleDialog::DoModal
更新 : 2007 年 11 月
モーダル ダイアログ ボックスを呼び出し、呼び出し後にその結果を返します。
INT_PTR DoModal(
HWND hWndParent = ::GetActiveWindow()
);
パラメータ
- hWndParent
ダイアログ ボックスの親へのハンドル。値を指定しない場合は、現在のアクティブ ウィンドウが親に設定されます。
戻り値
正常終了した場合は、ダイアログ ボックスを終了したコントロールのリソース ID を返します。
失敗した場合は –1 を返します。拡張エラー情報を表示するには GetLastError を呼び出します。
解説
このメソッドは、ダイアログ ボックスがアクティブな間、ユーザーとのすべてのやり取りを処理します。これにより、ダイアログ ボックスがモーダルになります。つまり、そのダイアログ ボックスを閉じるまで、ユーザーはほかのウィンドウを操作できません。
必要条件
ヘッダー : atlwin.h