CDialogEx Kelas

Kelas CDialogEx menentukan warna latar belakang dan gambar latar belakang kotak dialog.

Sintaks

class CDialogEx : public CDialog

Anggota

Konstruktor Publik

Nama	Deskripsi
CDialogEx::CDialogEx	Membuat CDialogEx objek.
CDialogEx::~CDialogEx	Destruktor.

Metode Publik

Nama	Deskripsi
CDialogEx::SetBackgroundColor	Mengatur warna latar belakang kotak dialog.
CDialogEx::SetBackgroundImage	Mengatur gambar latar belakang kotak dialog.

Keterangan

Untuk menggunakan CDialogEx kelas , dapatkan kelas kotak dialog Anda dari CDialogEx kelas alih-alih CDialog kelas .

Gambar kotak dialog disimpan dalam file sumber daya. Kerangka kerja secara otomatis menghapus gambar apa pun yang dimuat dari file sumber daya. Untuk menghapus gambar latar belakang saat ini secara terprogram, panggil CDialogEx::SetBackgroundImage metode atau terapkan penanganan OnDestroy aktivitas. Saat Anda memanggil CDialogEx::SetBackgroundImage metode , teruskan HBITMAP parameter sebagai handel gambar. Objek CDialogEx akan mengambil kepemilikan gambar dan menghapusnya jika m_bAutoDestroyBmp benderanya adalah TRUE.

Objek CDialogEx dapat menjadi induk CMFCPopupMenu objek Kelas . Objek CMFCPopupMenu Kelas memanggil CDialogEx::SetActiveMenu metode saat CMFCPopupMenu objek Kelas terbuka. Setelah itu, CDialogEx objek menangani peristiwa menu apa pun hingga CMFCPopupMenu objek Kelas ditutup.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

Persyaratan

Header: afxdialogex.h

CDialogEx::CDialogEx

Membuat CDialogEx objek.

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

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

Parameter

nIDTemplate
[di] ID sumber daya templat kotak dialog.

lpszTemplateName
[di] Nama sumber daya templat kotak dialog.

pParent
[di] Penunjuk ke jendela induk. Nilai defaultnya adalah NULL.

pParentWnd
[di] Penunjuk ke jendela induk. Nilai defaultnya adalah NULL.

Tampilkan Nilai

Keterangan

CDialogEx::SetBackgroundColor

Mengatur warna latar belakang kotak dialog.

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

Parameter

color
[di] Nilai warna RGB.

bRepaint
[di] TRUE untuk segera memperbarui layar; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Keterangan

CDialogEx::SetBackgroundImage

Mengatur gambar latar belakang kotak dialog.

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
[di] Handel ke gambar latar belakang.

uiBmpResId
[di] ID sumber daya gambar latar belakang.

location
[di] Salah CDialogEx::BackgroundLocation satu nilai yang menentukan lokasi gambar. Nilai yang valid meliputi BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT, dan BACKGR_BOTTOMRIGHT. Nilai defaultnya adalah BACKGR_TILE.

bAutoDestroy
[di] TRUE untuk secara otomatis menghancurkan gambar latar belakang; jika tidak, FALSE.

bRepaint
[di] TRUE untuk segera menggambar ulang kotak dialog; jika tidak, FALSE.

Tampilkan Nilai

Dalam sintaks kelebihan beban metode kedua, TRUE jika metode berhasil; jika tidak, FALSE.

Keterangan

Gambar yang Anda tentukan tidak direntangkan agar pas dengan area klien kotak dialog.

Lihat juga

Bagan Hierarki
Kelas
CMFCPopupMenu Kelas
CContextMenuManager Kelas