Класс CDialogEx

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Класс 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 CDialogEx После этого объект обрабатывает любое событие меню до закрытия CMFCPopupMenu объекта Class.

Иерархия наследования

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Требования

Заголовок:afxdialogex.h

CDialogEx::CDialogEx

Формирует объект CDialogEx.

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

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

Параметры

nIDTemplate
[in] Идентификатор ресурса шаблона диалогового окна.

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] Идентификатор ресурса фонового изображения.

location
[in] Одно из CDialogEx::BackgroundLocation значений, указывающих расположение изображения. Допустимые значения: BACKGR_TILE, , BACKGR_TOPLEFTBACKGR_TOPRIGHT, BACKGR_BOTTOMLEFTи BACKGR_BOTTOMRIGHT. Значение по умолчанию — BACKGR_TILE.

bAutoDestroy
[in] TRUE для автоматического уничтожения фонового изображения; FALSEв противном случае .

bRepaint
[in] TRUE для немедленного перерасхода диалогового окна; FALSEв противном случае .

Возвращаемое значение

В синтаксисе перегрузки второго метода, TRUE если метод выполнен успешно; в противном случае FALSE.

Замечания

Указанное изображение не растянуто для размещения клиентской области диалогового окна.

См. также

Диаграмма иерархии
Классы
CMFCPopupMenu Класс
CContextMenuManager Класс