Clase CDialogEx

La clase CDialogEx especifica el color de fondo y la imagen de fondo de un cuadro de diálogo.

Sintaxis

class CDialogEx : public CDialog

Miembros

Constructores públicos

Nombre	Descripción
CDialogEx::CDialogEx	Construye un objeto CDialogEx.
CDialogEx::~CDialogEx	Destructor.

Métodos públicos

Nombre	Descripción
CDialogEx::SetBackgroundColor	Establece el color de fondo del cuadro de diálogo.
CDialogEx::SetBackgroundImage	Establece la imagen de fondo del cuadro de diálogo.

Comentarios

Para usar la clase CDialogEx, derive la clase de cuadro de diálogo de la clase CDialogEx, en lugar de derivarla de la clase CDialog.

Las imágenes del cuadro de diálogo se almacenan en un archivo de recursos. El marco de trabajo elimina automáticamente cualquier imagen que se cargue desde el archivo de recursos. Para eliminar mediante programación la imagen de fondo actual, llame al método CDialogEx::SetBackgroundImage o implemente un controlador de eventos OnDestroy. Cuando se llama al método CDialogEx::SetBackgroundImage, pase un parámetro HBITMAP como manipulador de la imagen. El objeto CDialogEx tomará posesión de la imagen y la elimina si la marca m_bAutoDestroyBmp es TRUE.

Un objeto CDialogEx puede ser un elemento primario de un objeto Clase CMFCPopupMenu. El objeto Clase CMFCPopupMenu llama al método CDialogEx::SetActiveMenu cuando se abre el objeto Clase CMFCPopupMenu. A continuación, objeto CDialogEx controla cualquier evento de menú hasta que se cierre el objeto Clase CMFCPopupMenu.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Requisitos

Encabezadoafxdialogex.h:

CDialogEx::CDialogEx

Construye un objeto CDialogEx.

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

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

Parámetros

nIDTemplate
[entrada] Identificador de recurso de una plantilla de cuadro de diálogo.

lpszTemplateName
[entrada] Nombre del recurso de una plantilla de cuadro de diálogo.

pParent
[in] Puntero a la ventana primaria. El valor predeterminado es NULL.

pParentWnd
[in] Puntero a la ventana primaria. El valor predeterminado es NULL.

Valor devuelto

Comentarios

CDialogEx::SetBackgroundColor

Establece el color de fondo del cuadro de diálogo.

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

Parámetros

color
[in] Valor de color RGB.

bRepaint
[entrada] TRUE para actualizar inmediatamente la pantalla; de lo contrario, FALSE. El valor predeterminado es TRUE.

Comentarios

CDialogEx::SetBackgroundImage

Establece la imagen de fondo del cuadro de diálogo.

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);

Parámetros

hBitmap
[entrada] Manipulador de la imagen de fondo.

uiBmpResId
[entrada] Identificador de recurso de la imagen de fondo.

location
[entrada] Uno de los valores CDialogEx::BackgroundLocation que especifican la ubicación de la imagen. Los valores válidos incluyen BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT y BACKGR_BOTTOMRIGHT. El valor predeterminado es BACKGR_TILE.

bAutoDestroy
[entrada] TRUE para destruir automáticamente la imagen de fondo; de lo contrario, FALSE.

bRepaint
[entrada] TRUE para volver a dibujar inmediatamente el cuadro de diálogo; de lo contrario, FALSE.

Valor devuelto

En la segunda sintaxis de sobrecarga de método, TRUE si el método es correcto; de lo contrario, FALSE.

Comentarios

La imagen que especifique no se ajusta al área cliente del cuadro de diálogo.

Consulte también

Gráfico de jerarquías
Clases
CMFCPopupMenu (clase)
CContextMenuManager (clase)