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 对象可以是 CMFCPopupMenu 类对象的父级。 当 CMFCPopupMenu 类对象打开时，CMFCPopupMenu 类对象会调用 CDialogEx::SetActiveMenu。 此后，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 值之一，用于指定图像的位置。 有效值包括 BACKGR_TILE、BACKGR_TOPLEFT、BACKGR_TOPRIGHT、BACKGR_BOTTOMLEFT 和 BACKGR_BOTTOMRIGHT。 默认值为 BACKGR_TILE。

bAutoDestroy
[in] 若要自动销毁背景图像，则为 TRUE；否则为 FALSE。

bRepaint
[in] 若要立即重新绘制对话框，则为 TRUE；否则为 FALSE。

返回值

在第二个方法重载语法中，如果方法成功，则为 TRUE；否则为 FALSE。

注解

指定的图像不会拉伸来适应对话框工作区。

另请参阅

层次结构图
类
CMFCPopupMenu 类
CContextMenuManager 类