CDialogEx Klasa

Klasa CDialogEx określa kolor tła i obraz tła okna dialogowego.

Składnia

class CDialogEx : public CDialog

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CDialogEx::CDialogEx	CDialogEx Tworzy obiekt.
CDialogEx::~CDialogEx	Destruktor.

Metody publiczne

Nazwa/nazwisko	opis
CDialogEx::SetBackgroundColor	Ustawia kolor tła okna dialogowego.
CDialogEx::SetBackgroundImage	Ustawia obraz tła okna dialogowego.

Uwagi

Aby użyć klasy, utwórz klasę CDialogEx okna dialogowego CDialogEx z klasy zamiast CDialog klasy.

Obrazy okien dialogowych są przechowywane w pliku zasobu. Platforma automatycznie usuwa wszystkie obrazy ładowane z pliku zasobu. Aby programowo usunąć bieżący obraz tła, wywołaj metodę lub zaimplementuj CDialogEx::SetBackgroundImage program obsługi zdarzeń OnDestroy . Po wywołaniu CDialogEx::SetBackgroundImage metody przekaż HBITMAP parametr jako uchwyt obrazu. Obiekt CDialogEx przejmie własność obrazu i usunie go, jeśli flaga m_bAutoDestroyBmp to TRUE.

CDialogEx Obiekt może być obiektem nadrzędnym CMFCPopupMenu obiektu Class. Obiekt Class wywołuje metodę CDialogEx::SetActiveMenu po otwarciu CMFCPopupMenu obiektu Class.CMFCPopupMenu CDialogEx Następnie obiekt obsługuje dowolne zdarzenie menu do momentu CMFCPopupMenu zamknięcia obiektu Class.

Hierarchia dziedziczenia

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Wymagania

Nagłówek: afxdialogex.h

CDialogEx::CDialogEx

CDialogEx Tworzy obiekt.

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

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

Parametry

nIDTemplate
[in] Identyfikator zasobu szablonu okna dialogowego.

lpszTemplateName
[in] Nazwa zasobu szablonu okna dialogowego.

pParent
[in] Wskaźnik do okna nadrzędnego. Domyślna wartość to NULL.

pParentWnd
[in] Wskaźnik do okna nadrzędnego. Domyślna wartość to NULL.

Wartość zwracana

Uwagi

CDialogEx::SetBackgroundColor

Ustawia kolor tła okna dialogowego.

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

Parametry

color
[in] Wartość koloru RGB.

bRepaint
[in] TRUE aby natychmiast zaktualizować ekran; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

CDialogEx::SetBackgroundImage

Ustawia obraz tła okna dialogowego.

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

Parametry

hBitmap
[in] Uchwyt do obrazu tła.

uiBmpResId
[in] Identyfikator zasobu obrazu tła.

location
[in] CDialogEx::BackgroundLocation Jedna z wartości określających lokalizację obrazu. Prawidłowe wartości obejmują BACKGR_TILE, , BACKGR_TOPLEFT, BACKGR_BOTTOMLEFTBACKGR_TOPRIGHTi BACKGR_BOTTOMRIGHT. Domyślna wartość to BACKGR_TILE.

bAutoDestroy
[in] TRUE aby automatycznie zniszczyć obraz tła; w przeciwnym razie, FALSE.

bRepaint
[in] TRUE aby natychmiast ponownie narysować okno dialogowe; w przeciwnym razie, FALSE.

Wartość zwracana

W drugiej składni przeciążenia metody, TRUE jeśli metoda jest pomyślna; w przeciwnym razie FALSE.

Uwagi

Określony obraz nie jest rozciągnięty tak, aby pasował do obszaru klienta okna dialogowego.

Zobacz też

Wykres hierarchii
Klasy
CMFCPopupMenu Klasa
CContextMenuManager Klasa