Share via

CDialogEx クラス

  • [アーティクル]

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

構文

class CDialogEx : public CDialog

メンバー

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

名前 説明
CDialogEx::CDialogEx CDialogEx オブジェクトを構築します。
CDialogEx::~CDialogEx デストラクターです。

パブリック メソッド

名前 説明
CDialogEx::SetBackgroundColor ダイアログ ボックスの背景色を設定します。
CDialogEx::SetBackgroundImage ダイアログ ボックスの背景イメージを設定します。

解説

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

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

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

継承階層

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

必要条件

ヘッダー:afxdialogex.h

CDialogEx::CDialogEx

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

CDialogEx(
    UINT nIDTemplate,
    CWnd* pParent=NULL);

CDialogEx(
    LPCTSTR lpszTemplateName,
    CWnd* pParentWnd=NULL);

パラメーター

nIDTemplate
[in]ダイアログ ボックス テンプレートのリソース ID。

lpszTemplateName
[in]ダイアログ ボックス テンプレートのリソース名。

pParent
[in]親ウィンドウへのポインター。 既定値は NULL です。

pParentWnd
[in]親ウィンドウへのポインター。 既定値は NULL です。

戻り値

解説

CDialogEx::SetBackgroundColor

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

void SetBackgroundColor(
    COLORREF color,
    BOOL bRepaint=TRUE);

パラメーター

color
[in]RGB カラー値。

bRepaint
[in] TRUE画面を直ちに更新する。それ以外の場合は . FALSE 既定値は TRUE です。

解説

CDialogEx::SetBackgroundImage

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

void SetBackgroundImage(
    HBITMAP hBitmap,
    BackgroundLocation location=BACKGR_TILE,
    BOOL bAutoDestroy=TRUE,
    BOOL bRepaint=TRUE);

BOOL SetBackgroundImage(
    UINT uiBmpResId,
    BackgroundLocation location=BACKGR_TILE,
    BOOL bRepaint=TRUE);

パラメーター

hBitmap
[in]背景画像へのハンドル。

uiBmpResId
[in]背景画像のリソース ID。

location
[in]イメージの CDialogEx::BackgroundLocation 場所を指定する値の 1 つ。 有効な値にはBACKGR_TILE、、、BACKGR_TOPLEFT、、BACKGR_TOPRIGHTBACKGR_BOTTOMLEFT、および BACKGR_BOTTOMRIGHT. 既定値は BACKGR_TILE です。

bAutoDestroy
[in] TRUE背景画像を自動的に破棄する。それ以外の場合は . FALSE

bRepaint
[in] TRUEダイアログ ボックスをすぐに再描画する場合。それ以外の場合は . FALSE

戻り値

2 番目のメソッド オーバーロード構文では、 TRUE メソッドが成功した場合は 〗。それ以外の場合は . FALSE。

解説

指定したイメージは、ダイアログ ボックスのクライアント領域に合わせて拡大されません。

関連項目

階層図
クラス
CMFCPopupMenu クラス
CContextMenuManager クラス