Classe CDialogEx

A classe CDialogEx especifica a cor da tela de fundo e a imagem de fundo de uma caixa de diálogo.

Sintaxe

class CDialogEx : public CDialog

Membros

Construtores públicos

Métodos públicos

Comentários

Para usar a classe CDialogEx, derive sua classe de caixa de diálogo da classe CDialogEx em vez da classe CDialog.

As imagens da caixa de diálogo são armazenadas em um arquivo de recurso. A estrutura exclui automaticamente qualquer imagem carregada a partir do arquivo de recurso. Para programar a exclusão da imagem de fundo atual, chame o método CDialogEx::SetBackgroundImage ou implemente um manipulador de eventos OnDestroy. Ao chamar o método CDialogEx::SetBackgroundImage, passe um parâmetro HBITMAP como o identificador de imagem. O objeto CDialogEx assumirá a propriedade da imagem e a excluirá se o sinalizador m_bAutoDestroyBmp for TRUE.

Um objeto CDialogEx pode ser pai de um objeto da classe CMFCPopupMenu. O objeto da classe CMFCPopupMenu chama o método CDialogEx::SetActiveMenu quando o objeto da classe CMFCPopupMenu é aberto. Posteriormente, o objeto CDialogEx manipula qualquer evento de menu até que o objeto da classe CMFCPopupMenu seja fechado.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Requisitos

Cabeçalho: afxdialogex.h

CDialogEx::CDialogEx

Constrói um objeto CDialogEx.

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

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

Parâmetros

nIDTemplate
[in] A ID do recurso de um modelo de caixa de diálogo.

lpszTemplateName
[in] O nome do recurso de um modelo de caixa de diálogo.

pParent
[in] Um ponteiro para a janela pai. O valor padrão é NULL.

pParentWnd
[in] Um ponteiro para a janela pai. O valor padrão é NULL.

Valor de retorno

Comentários

CDialogEx::SetBackgroundColor

Define a cor da tela de fundo da caixa de diálogo.

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

Parâmetros

color
[in] Um valor de cor RGB.

bRepaint
[in] TRUE para atualizar a tela imediatamente. Caso contrário, FALSE. O valor padrão é TRUE.

Comentários

CDialogEx::SetBackgroundImage

Define a imagem de fundo da caixa 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
[in] Um identificador para a imagem de fundo.

uiBmpResId
[in] A ID do recurso da imagem de fundo.

location
[in] Um dos valores CDialogEx::BackgroundLocation que especificam o local da imagem. Os valores válidos incluem BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT e BACKGR_BOTTOMRIGHT. O valor padrão é BACKGR_TILE.

bAutoDestroy
[in] TRUE para destruir automaticamente a imagem de fundo; caso contrário, FALSE.

bRepaint
[in] TRUE para redesenhar imediatamente a caixa de diálogo; caso contrário, FALSE.

Valor de retorno

Na sintaxe de sobrecarga do segundo método, TRUE se o método for bem-sucedido; caso contrário, FALSE.

Comentários

A imagem especificada não está estendida para caber na área do cliente da caixa de diálogo.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCPopupMenu
Classe CContextMenuManager