Partilhar via

CDialogEx Classe

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

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

Sintaxe

class CDialogEx : public CDialog

Membros

Construtores Públicos

Nome Description
CDialogEx::CDialogEx Constrói um CDialogEx objeto.
CDialogEx::~CDialogEx Destruidor.

Métodos Públicos

Nome Description
CDialogEx::SetBackgroundColor Define a cor de fundo da caixa de diálogo.
CDialogEx::SetBackgroundImage Define a imagem de fundo da caixa de diálogo.

Observações

Para usar a CDialogEx classe, deriva a tua classe da caixa de diálogo a partir da CDialogEx classe em vez da classe CDialog .

As imagens das caixas de diálogo são armazenadas num ficheiro de recurso. O framework elimina automaticamente qualquer imagem carregada do ficheiro de recurso. Para eliminar programaticamente a imagem de fundo atual, chame o CDialogEx::SetBackgroundImage método ou implemente um OnDestroy gestor de eventos. Quando chamar o CDialogEx::SetBackgroundImage método, passe um HBITMAP parâmetro como o handle da imagem. O CDialogEx objeto assume a propriedade da imagem e apaga-a se a m_bAutoDestroyBmp flag for TRUE.

Um objeto pode ser pai de um CMFCPopupMenu objeto deCDialogEx Classe. O CMFCPopupMenu objeto Classe chama o CDialogEx::SetActiveMenu método quando o CMFCPopupMenu objeto Classe se abre. Depois, o CDialogEx objeto trata de qualquer evento do menu até que o CMFCPopupMenu objeto de Classe seja fechado.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Requerimentos

Cabeçalho:afxdialogex.h

CDialogEx::CDialogEx

Constrói um CDialogEx objeto.

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

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

Parâmetros

nIDTemplate
[dentro] O ID de recurso de um modelo de caixa de diálogo.

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

pParent
[dentro] Um apontador para a janela principal. O valor predefinido é NULL.

pParentWnd
[dentro] Um apontador para a janela principal. O valor predefinido é NULL.

Valor de retorno

Observações

CDialogEx::SetBackgroundColor

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

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

Parâmetros

color
[dentro] Um valor de cor RGB.

bRepaint
[dentro] TRUE para atualizar imediatamente o ecrã; caso contrário, FALSE. O valor predefinido é TRUE.

Observações

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
[dentro] Uma alça para a imagem de fundo.

uiBmpResId
[dentro] O ID do recurso da imagem de fundo.

location
[dentro] Um dos CDialogEx::BackgroundLocation valores que especifica a localização da imagem. Valores válidos incluem BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT, e BACKGR_BOTTOMRIGHT. O valor predefinido é BACKGR_TILE.

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

bRepaint
[dentro] 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.

Observações

A imagem que especificas não está esticada para caber na área do cliente da caixa de diálogo.

Consulte também

Gráfico de Hierarquia
Classes
CMFCPopupMenu Classe
CContextMenuManager Classe

  • Last updated on