CDialogEx-Klasse

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

Syntax

class CDialogEx : public CDialog

Member

Ö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. Rufen Sie die CDialogEx::SetBackgroundImage Methode auf, oder implementieren Sie einen OnDestroy Ereignishandler, um das aktuelle Hintergrundbild programmgesteuert zu löschen. Wenn Sie die CDialogEx::SetBackgroundImage Methode aufrufen, übergeben Sie einen HBITMAP Parameter als Bildhandle. 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 Objekt eines CMFCPopupMenu Class-Objekts sein. Das CMFCPopupMenu Class-Objekt ruft die CDialogEx::SetActiveMenu Methode auf, wenn das CMFCPopupMenu Class-Objekt geöffnet wird. Anschließend behandelt das CDialogEx Objekt jedes Menüereignis, bis das CMFCPopupMenu Class-Objekt geschlossen wird.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Anforderungen

Header: afxdialogex.h

CDialogEx::CDialogEx

Erstellt ein CDialogEx-Objekt.

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

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

Parameter

nIDTemplate
[in] Die Ressourcen-ID einer Dialogfeldvorlage.

lpszTemplateName
[in] Der Ressourcenname einer Dialogfeldvorlage.

pParent
[in] Ein Zeiger auf das übergeordnete Fenster. Der Standardwert ist NULL.

pParentWnd
[in] Ein Zeiger auf das übergeordnete Fenster. Der Standardwert ist NULL.

Rückgabewert

Bemerkungen

CDialogEx::SetBackgroundColor

Legt die Hintergrundfarbe des Dialogfelds fest.

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

Parameter

color
[in] Ein RGB-Farbwert.

bRepaint
[in] TRUE um den Bildschirm sofort zu aktualisieren; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

CDialogEx::SetBackgroundImage

Legt das Hintergrundbild des Dialogfelds fest.

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

Parameter

hBitmap
[in] Ein Handle für das Hintergrundbild.

uiBmpResId
[in] Die Ressourcen-ID des Hintergrundbilds.

location
[in] Einer der CDialogEx::BackgroundLocation Werte, die die Position des Bilds angeben. Gültige Werte sind : BACKGR_TILE, BACKGR_TOPLEFT, , BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFTund BACKGR_BOTTOMRIGHT. Der Standardwert ist BACKGR_TILE.

bAutoDestroy
[in] TRUE um das Hintergrundbild automatisch zu zerstören; andernfalls . FALSE

bRepaint
[in] TRUE um das Dialogfeld sofort neu zu zeichnen; andernfalls . FALSE

Rückgabewert

In der zweiten Methodenüberladungssyntax, TRUE wenn die Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Das von Ihnen angegebene Bild wird nicht gestreckt, um den Clientbereich des Dialogfelds anzupassen.

Siehe auch

Hierarchiediagramm
Klassen
CMFCPopupMenu Klasse
CContextMenuManager Klasse