Classe CDialogEx

  • Articolo

La classe CDialogEx specifica il colore e l'immagine di sfondo di una finestra di dialogo.

Sintassi

class CDialogEx : public CDialog

Membri

Costruttori pubblici

Nome Descrizione
CDialogEx::CDialogEx Costruisce un oggetto CDialogEx.
CDialogEx::~CDialogEx Distruttore.

Metodi pubblici

Nome Descrizione
CDialogEx::SetBackgroundColor Imposta il colore di sfondo della finestra di dialogo.
CDialogEx::SetBackgroundImage Imposta l'immagine di sfondo della finestra di dialogo.

Osservazioni:

Per usare la classe CDialogEx, derivare la classe della finestra di dialogo dalla classe CDialogEx e non dalla classe CDialog.

Le immagini della finestra di dialogo vengono archiviate in un file di risorse. Il framework elimina automaticamente tutte le immagini caricate dal file di risorse. Per eliminare a livello di codice l'immagine di sfondo corrente, chiamare il CDialogEx::SetBackgroundImage metodo o implementare un OnDestroy gestore eventi. Quando si chiama il CDialogEx::SetBackgroundImage metodo , passare un HBITMAP parametro come handle immagine. L'oggetto CDialogEx diventa proprietario dell'immagine e la elimina se il flag m_bAutoDestroyBmp è TRUE.

Un CDialogEx oggetto può essere un elemento padre di un CMFCPopupMenu oggetto Class . L'oggetto CMFCPopupMenu Class chiama il CDialogEx::SetActiveMenu metodo all'apertura dell'oggettoCMFCPopupMenu Class. Successivamente, l'oggetto CDialogEx gestisce qualsiasi evento di menu fino alla chiusura dell'oggetto CMFCPopupMenu Class .

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Requisiti

Intestazione: afxdialogex.h

CDialogEx::CDialogEx

Costruisce un oggetto CDialogEx.

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

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

Parametri

nIDTemplate
[in] ID risorsa di un modello di finestra di dialogo.

lpszTemplateName
[in] Nome della risorsa di un modello di finestra di dialogo.

pParent
[in] Puntatore alla finestra padre. Il valore predefinito è NULL.

pParentWnd
[in] Puntatore alla finestra padre. Il valore predefinito è NULL.

Valore restituito

Osservazioni:

CDialogEx::SetBackgroundColor

Imposta il colore di sfondo della finestra di dialogo.

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

Parametri

color
[in] Valore di colore RGB.

bRepaint
[in] TRUE per aggiornare immediatamente lo schermo; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CDialogEx::SetBackgroundImage

Imposta l'immagine di sfondo della finestra di dialogo.

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

Parametri

hBitmap
[in] Handle per l'immagine di sfondo.

uiBmpResId
[in] ID risorsa dell'immagine di sfondo.

location
[in] Uno dei CDialogEx::BackgroundLocation valori che specificano la posizione dell'immagine. I valori validi includono BACKGR_TILE, BACKGR_TOPLEFTBACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT, e BACKGR_BOTTOMRIGHT. Il valore predefinito è BACKGR_TILE.

bAutoDestroy
[in] TRUE per distruggere automaticamente l'immagine di sfondo; in caso contrario, FALSE.

bRepaint
[in] TRUE per ridisegnare immediatamente la finestra di dialogo; in caso contrario, FALSE.

Valore restituito

Nella sintassi del secondo overload del metodo, TRUE se il metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

L'immagine specificata non è estesa in base all'area client della finestra di dialogo.

Vedi anche

Grafico della gerarchia
Classi
CMFCPopupMenu Classe
CContextMenuManager Classe