CDialogEx-Klasse

Artikel
06/10/2015

Die CDialogEx-Klasse gibt die Hintergrundfarbe und das Hintergrundbild eines Dialogfelds an.

class CDialogEx : public CDialog

Mitglieder

Öffentliche Konstruktoren

Name	Beschreibung
CDialogEx::CDialogEx	Erstellt ein CDialogEx-Objekt.
CDialogEx::~CDialogEx	Destruktor.

Öffentliche Methoden

Name	Beschreibung
CDialogEx::SetBackgroundColor	Legt die Hintergrundfarbe des Dialogfelds fest.
CDialogEx::SetBackgroundImage	Legt das Hintergrundbild des Dialogfelds fest.

Hinweise

Zum Verwenden der CDialogEx-Klasse müssen Sie Ihre Dialogfeldklasse von der CDialogEx-Klasse statt der CDialog-Klasse ableiten.

Dialogfeldbilder werden in einer Ressourcendatei gespeichert. Das Framework löscht automatisch jedes Bild, das aus der Ressourcendatei geladen wird. Um das aktuelle Hintergrundbild programmgesteuert zu löschen, rufen Sie die CDialogEx::SetBackgroundImage-Methode auf, oder implementieren Sie einen OnDestroy-Ereignishandler. Beim Aufrufen der CDialogEx::SetBackgroundImage-Methode übergeben Sie einen HBITMAP-Parameter als Bild-Handle. Das CDialogEx-Objekt übernimmt den Besitz des Bilds und löscht es, wenn das m_bAutoDestroyBmp -Flag TRUE ist.

Ein CDialogEx-Objekt kann ein übergeordnetes Element eines CMFCPopupMenu-Klasse-Objekts sein. Das CMFCPopupMenu-Klasse-Objekt ruft die CDialogEx::SetActiveMenu-Methode auf, wenn das CMFCPopupMenu-Klasse-Objekt geöffnet wird. Danach verarbeitet das CDialogEx-Objekt alle Menüereignisse, bis das CMFCPopupMenu-Klasse-Objekt geschlossen ist.