CDialogEx 類別
CDialogEx 類別會指定對話方塊的背景影像和背景色彩。
語法
class CDialogEx : public CDialog
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
CDialogEx::CDialogEx |
建構 CDialogEx 物件。 |
CDialogEx::~CDialogEx |
解構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
CDialogEx::SetBackgroundColor |
設定對話方塊的背景色彩。 |
CDialogEx::SetBackgroundImage |
設定對話方塊的背景影像。 |
備註
若要使用 CDialogEx 類別，請將您的對話方塊類別從 CDialogEx 類別進行衍生，而不是從 CDialog 類別。
對話方塊影像會儲存在資源檔中。 架構會自動刪除從資源檔載入的任何影像。 若要以程式設計方式刪除目前的背景影像，請呼叫 CDialogEx::SetBackgroundImage 方法或實作 OnDestroy 事件處理程式。 當您呼叫 方法時 CDialogEx::SetBackgroundImage ，傳入 HBITMAP 參數做為影像句柄。 CDialogEx 物件會取得影像的擁有權，而若 m_bAutoDestroyBmp 旗標是 TRUE 的話，則會將它刪除。
CDialogEx物件可以是 Class 物件的父CMFCPopupMenu代。 CMFCPopupMenu Class 物件會在 Class 物件開啟時CMFCPopupMenu呼叫 CDialogEx::SetActiveMenu 方法。 之後，對象會 CDialogEx 處理任何功能表事件， CMFCPopupMenu 直到 Class 物件關閉為止。
繼承階層架構
需求
標頭： afxdialogex.h
CDialogEx::CDialogEx
建構 CDialogEx 物件。
CDialogEx(
UINT nIDTemplate,
CWnd* pParent=NULL);
CDialogEx(
LPCTSTR lpszTemplateName,
CWnd* pParentWnd=NULL);
參數
nIDTemplate
[in]對話框範本的資源識別碼。
lpszTemplateName
[in]對話框範本的資源名稱。
pParent
[in]父視窗的指標。 預設值是 NULL。
pParentWnd
[in]父視窗的指標。 預設值是 NULL。
傳回值
備註
CDialogEx::SetBackgroundColor
設定對話方塊的背景色彩。
void SetBackgroundColor(
COLORREF color,
BOOL bRepaint=TRUE);
參數
color
[in]RGB 色彩值。
bRepaint
[in] TRUE 表示立即更新畫面;否則為 FALSE。 預設值是 TRUE。
備註
CDialogEx::SetBackgroundImage
設定對話方塊的背景影像。
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);
參數
hBitmap
[in]背景影像的句柄。
uiBmpResId
[in]背景影像的資源標識碼。
location
[in]其中 CDialogEx::BackgroundLocation 一個值，指定影像的位置。 有效值包括 BACKGR_TILE、 BACKGR_TOPLEFT、 BACKGR_TOPRIGHT、 BACKGR_BOTTOMLEFT和 BACKGR_BOTTOMRIGHT。 預設值是 BACKGR_TILE。
bAutoDestroy
[in] TRUE 表示自動終結背景影像;否則為 FALSE。
bRepaint
[in] TRUE 表示立即重新繪製對話框;否則為 FALSE。
傳回值
在第二個方法多載語法中，如果方法成功， TRUE 則為 ，否則為 FALSE。
備註
您指定的影像不會伸展以符合對話框工作區。