Sdílet prostřednictvím

CDialogEx Třída

  • Článek

Třída CDialogEx určuje barvu pozadí a obrázek pozadí dialogového okna.

Syntaxe

class CDialogEx : public CDialog

Členové

Veřejné konstruktory

Název Popis
CDialogEx::CDialogEx CDialogEx Vytvoří objekt.
CDialogEx::~CDialogEx Destruktor.

Veřejné metody

Název Popis
CDialogEx::SetBackgroundColor Nastaví barvu pozadí dialogového okna.
CDialogEx::SetBackgroundImage Nastaví obrázek pozadí dialogového okna.

Poznámky

Chcete-li použít třídu, odvodit třídu dialogového CDialogEx okna z CDialogEx třídy namísto CDialog třídy.

Obrázky dialogového okna jsou uloženy v souboru prostředků. Architektura automaticky odstraní všechny image načtené ze souboru prostředků. Pokud chcete odstranit aktuální obrázek na pozadí prostřednictvím kódu programu, zavolejte metodu CDialogEx::SetBackgroundImage nebo implementujte obslužnou rutinu OnDestroy události. Při volání CDialogEx::SetBackgroundImage metody předejte HBITMAP parametr jako popisovač obrázku. Objekt CDialogEx převezme vlastnictví image a odstraní jej, pokud m_bAutoDestroyBmp je TRUEpříznak .

Objekt CDialogEx může být nadřazený CMFCPopupMenu objekt třídy . Objekt CMFCPopupMenu Class volá metodu CDialogEx::SetActiveMenu při otevření objektu CMFCPopupMenu Class . Poté objekt CDialogEx zpracovává všechny události nabídky, dokud CMFCPopupMenu se objekt Třídy zavře.

Hierarchie dědičnosti

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Požadavky

Záhlaví: afxdialogex.h

CDialogEx::CDialogEx

CDialogEx Vytvoří objekt.

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

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

Parametry

nIDTemplate
[v] ID prostředku šablony dialogového okna

lpszTemplateName
[v] Název prostředku šablony dialogového okna

pParent
[v] Ukazatel na nadřazené okno. Výchozí hodnota je NULL.

pParentWnd
[v] Ukazatel na nadřazené okno. Výchozí hodnota je NULL.

Návratová hodnota

Poznámky

CDialogEx::SetBackgroundColor

Nastaví barvu pozadí dialogového okna.

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

Parametry

color
[v] Hodnota barvy RGB.

bRepaint
[v] TRUE okamžitě aktualizovat obrazovku; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

CDialogEx::SetBackgroundImage

Nastaví obrázek pozadí dialogového okna.

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
[v] Úchyt obrázku na pozadí.

uiBmpResId
[v] ID prostředku obrázku na pozadí.

location
[v] Jedna z CDialogEx::BackgroundLocation hodnot, které určují umístění obrázku. Platné hodnoty zahrnují BACKGR_TILE, , BACKGR_TOPRIGHTBACKGR_TOPLEFT, BACKGR_BOTTOMLEFT, a BACKGR_BOTTOMRIGHT. Výchozí hodnota je BACKGR_TILE.

bAutoDestroy
[v] TRUE k automatickému zničení obrázku pozadí; v opačném případě . FALSE

bRepaint
[v] TRUE k okamžitému překreslení dialogového okna; v opačném případě . FALSE

Návratová hodnota

V druhé syntaxi přetížení metody, TRUE pokud je metoda úspěšná; v opačném případě . FALSE

Poznámky

Zadaný obrázek není roztažený tak, aby odpovídal klientské oblasti dialogového okna.

Viz také

Graf hierarchie
Třídy
CMFCPopupMenu Třída
CContextMenuManager Třída