Udostępnij za pośrednictwem

CDialogEx Klasa

Uwaga / Notatka

Biblioteka Klas programu Microsoft Foundation (MFC) nadal jest obsługiwana. Nie dodajemy już funkcji ani nie aktualizujemy dokumentacji.

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 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_TOPRIGHTBACKGR_BOTTOMLEFTi 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

  • Last updated on