CDialogEx osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CDialogEx osztály egy párbeszédpanel háttérszínét és háttérképét adja meg.

Szemantika

class CDialogEx : public CDialog

Tagok

Nyilvános konstruktorok

Név	Description
CDialogEx::CDialogEx	Egy CDialogEx objektumot hoz létre.
CDialogEx::~CDialogEx	Destruktor.

Nyilvános metódusok

Név	Description
CDialogEx::SetBackgroundColor	Beállítja a párbeszédpanel háttérszínét.
CDialogEx::SetBackgroundImage	Beállítja a párbeszédpanel háttérképét.

Megjegyzések

Az CDialogEx osztály használatához a párbeszédpanel-osztályt az osztály helyett az CDialogEx osztályból származtathatja CDialog .

A párbeszédpanel lemezképei erőforrásfájlban vannak tárolva. A keretrendszer automatikusan törli az erőforrásfájlból betöltött összes képet. Az aktuális háttérkép programozott törléséhez hívja meg a metódust CDialogEx::SetBackgroundImage , vagy implementáljon egy eseménykezelőt OnDestroy . Amikor meghívja a metódust CDialogEx::SetBackgroundImage , adjon meg egy paramétert HBITMAP képfogópontként. Az CDialogEx objektum átveszi a kép tulajdonjogát, és törli, ha a m_bAutoDestroyBmp jelölő az TRUE.

Egy CDialogEx objektum lehet osztályobjektumCMFCPopupMenu szülője. Az CMFCPopupMenu osztályobjektum meghívja a metódust az CDialogEx::SetActiveMenuCMFCPopupMenu Osztály objektum megnyitásakor. Ezt követően az CDialogEx objektum az osztályobjektum bezárásáig kezeli a CMFCPopupMenu menüeseményeket.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Requirements

Fejléc:afxdialogex.h

CDialogEx::CDialogEx

Egy CDialogEx objektumot hoz létre.

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

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

Paraméterek

nIDTemplate
[in] Egy párbeszédpanelsablon erőforrás-azonosítója.

lpszTemplateName
[in] Egy párbeszédpanelsablon erőforrásneve.

pParent
[in] Mutató a szülőablakra. Az alapértelmezett érték a NULL.

pParentWnd
[in] Mutató a szülőablakra. Az alapértelmezett érték a NULL.

Visszaadott érték

Megjegyzések

CDialogEx::SetBackgroundColor

Beállítja a párbeszédpanel háttérszínét.

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

Paraméterek

color
[in] RGB-színérték.

bRepaint
[in] TRUE a képernyő azonnali frissítése; egyéb esetben. FALSE Az alapértelmezett érték a TRUE.

Megjegyzések

CDialogEx::SetBackgroundImage

Beállítja a párbeszédpanel háttérképét.

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

Paraméterek

hBitmap
[in] A háttérkép fogópontja.

uiBmpResId
[in] A háttérkép erőforrás-azonosítója.

location
[in] CDialogEx::BackgroundLocation A kép helyét meghatározó értékek egyike. Az érvényes értékek a következők: BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_BOTTOMLEFTBACKGR_TOPRIGHT, és BACKGR_BOTTOMRIGHT. Az alapértelmezett érték a BACKGR_TILE.

bAutoDestroy
[in] TRUE a háttérkép automatikus megsemmisítése; egyéb esetben. FALSE

bRepaint
[in] TRUE a párbeszédpanel azonnali újraírásához; egyéb esetben. FALSE

Visszaadott érték

A második metódus túlterhelési szintaxisa, TRUE ha a metódus sikeres; ellenkező esetben. FALSE

Megjegyzések

A megadott kép nem a párbeszédpanel ügyfélterületéhez igazodik.

Lásd még

hierarchiadiagram
osztályok
CMFCPopupMenu osztály
CContextMenuManager osztály