CDialogEx クラス

更新 : 2007 年 11 月

CDialogEx クラスは、ダイアログ ボックスの背景色と背景イメージを指定します。

class CDialogEx : public CDialog

メンバ

パブリック コンストラクタ

名前

説明

CDialogEx::CDialogEx

CDialogEx オブジェクトを構築します。

CDialogEx::~CDialogEx

デストラクタです。

パブリック メソッド

名前

説明

CDialogEx::GetThisClass

このクラス型に関連付けられた CRuntimeClass オブジェクトへのポインタを取得するために、フレームワークによって使用されます。

CDialogEx::PreTranslateMessage

Windows 関数の TranslateMessageDispatchMessage にディスパッチする前にウィンドウ メッセージを変換します。詳細とメソッド構文については、「CWnd::PreTranslateMessage」を参照してください。(CDialog::PreTranslateMessage をオーバーライドします。)

CDialogEx::SetBackgroundColor

ダイアログ ボックスの背景色を設定します。

CDialogEx::SetBackgroundImage

ダイアログ ボックスの背景イメージを設定します。

解説

CDialogEx クラスを使用するには、ダイアログ ボックス クラスを CDialog クラスではなく、CDialogEx クラスから派生させます。

ダイアログ ボックス イメージはリソース ファイルに格納されます。フレームワークは、リソース ファイルから読み込まれたイメージを自動的に削除します。現在の背景イメージをプログラムで削除するには、CDialogEx::SetBackgroundImage メソッドを呼び出すか、OnDestroy イベント ハンドラを実装します。CDialogEx::SetBackgroundImage メソッドを呼び出すときには、イメージ ハンドルとして HBITMAP パラメータを渡します。CDialogEx オブジェクトがイメージの所有権を継承し、m_bAutoDestroyBmp フラグが TRUE である場合は、そのイメージを削除します。

CDialogEx オブジェクトは、CMFCPopupMenu クラス オブジェクトの親になることができます。CMFCPopupMenu クラス オブジェクトは、CMFCPopupMenu クラス オブジェクトが開いたときに CDialogEx::SetActiveMenu メソッドを呼び出します。その後、CDialogEx オブジェクトは、CMFCPopupMenu クラス オブジェクトが閉じられるまで、あらゆるメニュー イベントを処理します。

継承階層

CObject

   CCmdTarget

      CWnd

         CDialog

            CDialogEx

必要条件

ヘッダー : afxdialogex.h

参照

概念

MFC 階層図

参照

CMFCPopupMenu クラス

CContextMenuManager クラス

その他の技術情報

クラス (MFC Feature Pack)