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 类对象关闭。
继承层次结构
要求
标头：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。
注解
指定的图像不会拉伸来适应对话框工作区。