CDialogEx-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CDialogEx klasse geeft de achtergrondkleur en achtergrondafbeelding van een dialoogvenster op.

Syntaxis

class CDialogEx : public CDialog

Leden

Openbare constructors

Naam	Description
CDialogEx::CDialogEx	Maakt een CDialogEx object.
CDialogEx::~CDialogEx	Destructor.

Openbare methoden

Naam	Description
CDialogEx::SetBackgroundColor	Hiermee stelt u de achtergrondkleur van het dialoogvenster in.
CDialogEx::SetBackgroundImage	Hiermee stelt u de achtergrondafbeelding van het dialoogvenster in.

Opmerkingen

Als u de CDialogEx klasse wilt gebruiken, moet u de dialoogvensterklasse afleiden uit de CDialogEx klas in plaats van de CDialog klasse.

Dialoogvensterafbeeldingen worden opgeslagen in een resourcebestand. In het framework worden automatisch alle installatiekopieën verwijderd die uit het resourcebestand worden geladen. Als u de huidige achtergrondafbeelding programmatisch wilt verwijderen, roept u de CDialogEx::SetBackgroundImage methode aan of implementeert u een OnDestroy gebeurtenis-handler. Wanneer u de CDialogEx::SetBackgroundImage methode aanroept, geeft u een HBITMAP parameter door als de afbeeldingsgreep. Het CDialogEx object wordt eigenaar van de afbeelding en wordt verwijderd als de m_bAutoDestroyBmp vlag is TRUE.

Een CDialogEx object kan een bovenliggend element van een CMFCPopupMenu klasseobject zijn. Het CMFCPopupMenu klasseobject roept de CDialogEx::SetActiveMenu methode aan wanneer het CMFCPopupMenu klasseobject wordt geopend. Daarna verwerkt het CDialogEx object een menu-gebeurtenis totdat het CMFCPopupMenu klasseobject is gesloten.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Requirements

Rubriek:afxdialogex.h

CDialogEx::CDialogEx

Maakt een CDialogEx object.

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

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

Parameterwaarden

nIDTemplate
[in] De resource-id van een dialoogvenstersjabloon.

lpszTemplateName
[in] De resourcenaam van een dialoogvenstersjabloon.

pParent
[in] Een aanwijzer naar het bovenliggende venster. De standaardwaarde is NULL.

pParentWnd
[in] Een aanwijzer naar het bovenliggende venster. De standaardwaarde is NULL.

Retourwaarde

Opmerkingen

CDialogEx::SetBackgroundColor

Hiermee stelt u de achtergrondkleur van het dialoogvenster in.

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

Parameterwaarden

color
[in] Een RGB-kleurwaarde.

bRepaint
[in] TRUE om het scherm onmiddellijk bij te werken; anders, FALSE. De standaardwaarde is TRUE.

Opmerkingen

CDialogEx::SetBackgroundImage

Hiermee stelt u de achtergrondafbeelding van het dialoogvenster in.

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

Parameterwaarden

hBitmap
[in] Een ingang naar de achtergrondafbeelding.

uiBmpResId
[in] De resource-id van de achtergrondafbeelding.

location
[in] Een van de CDialogEx::BackgroundLocation waarden die de locatie van de afbeelding opgeven. Geldige waarden zijn onder andere BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHTen BACKGR_BOTTOMLEFTBACKGR_BOTTOMRIGHT. De standaardwaarde is BACKGR_TILE.

bAutoDestroy
[in] TRUE om de achtergrondafbeelding automatisch te vernietigen; anders, FALSE.

bRepaint
[in] TRUE om het dialoogvenster onmiddellijk opnieuw te tekenen; anders, FALSE.

Retourwaarde

In de syntaxis van de tweede methode overbelasting, TRUE als de methode is geslaagd; anders. FALSE

Opmerkingen

De afbeelding die u opgeeft, is niet uitgerekt zodat deze past bij het clientgebied van het dialoogvenster.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCPopupMenu klasse
CContextMenuManager klasse