CSimpleDialog クラス

  • [アーティクル]

このクラスでは、基本的なモーダル ダイアログ ボックスが実装されます。

構文

template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase

パラメーター

t_wDlgTemplateID

ダイアログ テンプレート リソースのリソース ID。

t_bCenter
ダイアログ オブジェクトが所有者ウィンドウの中央に表示される場合は TRUE。それ以外の場合は FALSE。

メンバー

パブリック メソッド

名前 説明
CSimpleDialog::DoModal モーダル ダイアログ ボックスを作成します。

解説

基本的な機能を持つモーダル ダイアログ ボックスを実装します。 CSimpleDialog では、Windows コモン コントロールのサポートのみが提供されます。 モーダル ダイアログ ボックスを作成し、表示するには、このクラスのインスタンスを作成し、ダイアログ ボックスの既存のリソース テンプレートの名前を指定します。 ダイアログ ボックス オブジェクトは、値が事前定義された (IDOK や IDCANCEL など) コントロールをユーザーがクリックすると閉じられます。

CSimpleDialog では、モーダル ダイアログ ボックスのみを作成できます。 CSimpleDialog により、既定のメッセージ マップを使用し、該当するハンドラーにメッセージを送信するダイアログ ボックス プロシージャが提供されます。

詳細については、「ダイアログ ボックスの実装」を参照してください。

継承階層

CDialogImplBase

CSimpleDialog

必要条件

ヘッダー: atlwin.h

CSimpleDialog::DoModal

モーダル ダイアログ ボックスを呼び出し、完了時にダイアログ ボックスの結果を返します。

INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());

パラメーター

hWndParent
ダイアログ ボックスの親へのハンドル。 値が指定されていない場合、親は現在アクティブなウィンドウに設定されます。

戻り値

成功した場合、戻り値は、ダイアログ ボックスを閉じたコントロールのリソース ID になります。

関数が失敗した場合、戻り値は -1 です。 拡張されたエラー情報を取得するには、GetLastError を呼び出します。

解説

このメソッドによって、ダイアログがアクティブになっている間のユーザーとのすべてのやりとりが処理されます。 それによりダイアログ ボックスがモーダルになります。つまり、ダイアログ ボックスが閉じられるまでユーザーは他のウィンドウとやりとりできません。

関連項目

クラスの概要