Kelas CPaneDialog
Kelas CPaneDialog mendukung kotak dialog yang modeless dan dapat di-dock.
Sintaks
class CPaneDialog : public CDockablePane
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
CPaneDialog::CPaneDialog |
Konstruktor default. |
CPaneDialog::~CPaneDialog |
Destruktor. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CPaneDialog::Create | Membuat kotak dialog yang dapat ditampung dan melampirkannya ke CPaneDialog objek. |
CPaneDialog::CreateObject |
Digunakan oleh kerangka kerja untuk membuat instans dinamis dari jenis kelas ini. |
CPaneDialog::GetThisClass |
Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke objek CRuntimeClass yang terkait dengan jenis kelas ini. |
| CPaneDialog::HandleInitDialog | Menangani pesan WM_INITDIALOG. (Mendefiniskan ulang CBasePane::HandleInitDialog.) |
CPaneDialog::OnEraseBkgnd |
Menangani pesan WM_ERASEBKGND. (Terdefinis ulang CWnd::OnEraseBkgnd.) |
CPaneDialog::OnLButtonDblClk |
Menangani pesan WM_LBUTTONDBLCLK. (Terdefinis ulang CWnd::OnLButtonDblClk.) |
CPaneDialog::OnLButtonDown |
Menangani pesan WM_LBUTTONDOWN. (Terdefinis ulang CWnd::OnLButtonDown.) |
CPaneDialog::OnUpdateCmdUI |
Dipanggil oleh kerangka kerja untuk memperbarui jendela kotak dialog. (Penimpaan CDockablePane::OnUpdateCmdUI.) |
CPaneDialog::OnWindowPosChanging |
Menangani pesan WM_WINDOWPOSCHANGING. (Terdefinis ulang CWnd::OnWindowPosChanging.) |
| CPaneDialog::SetOccDialogInfo | Menentukan templat untuk kotak dialog yang merupakan kontainer kontrol OLE. |
Keterangan
Buat CPaneDialog objek dalam dua langkah. Pertama, buat objek dalam kode Anda. Kedua, panggil CPaneDialog::Create. Anda harus menentukan nama templat sumber daya atau ID templat yang valid dan meneruskan penunjuk ke jendela induk. Jika tidak, proses pembuatan gagal. Kotak dialog harus menentukan gaya WS_CHILD dan WS_VISIBLE. Sebaiknya Anda juga menentukan gaya WS_CLIPCHILDREN dan WS_CLIPSIBLINGS. Untuk informasi selengkapnya, lihat Gaya Jendela.
Hierarki Warisan
Persyaratan
Header: afxpanedialog.h
CPaneDialog::Create
Membuat kotak dialog docking dan melampirkannya ke CPaneDialog objek.
BOOL Create(
LPCTSTR lpszWindowName,
CWnd* pParentWnd,
BOOL bHasGripper,
LPCTSTR lpszTemplateName,
UINT nStyle,
UINT nID,
DWORD dwTabbedStyle= AFX_CBRS_REGULAR_TABS,
DWORD dwControlBarStyle=AFX_DEFAULT_DOCKING_PANE_STYLE);
BOOL Create(
LPCTSTR lpszWindowName,
CWnd* pParentWnd,
BOOL bHasGripper,
UINT nIDTemplate,
UINT nStyle,
UINT nID);
BOOL Create(
CWnd* pParentWnd,
LPCTSTR lpszTemplateName,
UINT nStyle,
UINT nID);
BOOL Create(
CWnd* pParentWnd,
UINT nIDTemplate,
UINT nStyle,
UINT nID);
Parameter
lpszWindowName
[di] Nama kotak dialog docking.
pParentWnd
[di] Menunjuk ke jendela induk.
bHasGripper
[di] TRUE untuk membuat kotak dialog docking dengan keterangan (gripper); jika tidak, FALSE.
lpszTemplateName
[di] Nama templat dialog sumber daya.
nStyle
[di] Gaya Windows.
Nid
[di] ID kontrol.
nIDTemplate
[di] ID sumber daya templat dialog.
dwTabbedStyle
[di] Gaya jendela bertab yang menghasilkan saat pengguna menyeret panel kontrol lain ke keterangan panel kontrol ini. Nilai defaultnya adalah AFX_CBRS_REGULAR_TABS. Untuk informasi selengkapnya, lihat bagian Keterangan dari metode CBasePane::CreateEx .
dwControlBarStyle
[di] Atribut gaya tambahan. Nilai defaultnya adalah AFX_DEFAULT_DOCKING_PANE_STYLE. Untuk informasi selengkapnya, lihat bagian Keterangan dari metode CBasePane::CreateEx .
Tampilkan Nilai
TRUE jika metode ini berhasil; jika tidak, FALSE.
Keterangan
Contoh
Contoh berikut menunjukkan cara menggunakan Create metode di CPaneDialog kelas . Contoh ini adalah bagian dari sampel Atur Ukuran Panel.
CPaneDialog m_wndDlgBar;
// The this pointer points to a CMainFrame class which extends the CFrameWnd class.
if (!m_wndDlgBar.Create(_T("DialogBar"), this, TRUE,
MAKEINTRESOURCE(IDD_DLG_BAR),
WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_LEFT | CBRS_FLOAT_MULTI,
ID_VIEW_DLGBAR))
{
TRACE0("Failed to create Dialog Bar\n");
return FALSE; // fail to create
}
CPaneDialog::HandleInitDialog
Menangani pesan WM_INITDIALOG.
afx_msg LRESULT HandleInitDialog(
WPARAM wParam,
LPARAM lParam);
Parameter
wParam
[di] Tangani ke kontrol untuk menerima fokus keyboard default.
lParam
[di] Menentukan data inisialisasi tambahan.
Tampilkan Nilai
TRUE jika metode ini berhasil; jika tidak, FALSE. Selain itu, TRUE mengatur fokus keyboard ke kontrol yang ditentukan oleh parameter wParam ; FALSE mencegah pengaturan fokus keyboard default.
Keterangan
Kerangka kerja menggunakan metode ini untuk menginisialisasi kontrol dan tampilan kotak dialog. Kerangka kerja memanggil metode ini sebelum menampilkan kotak dialog.
CPaneDialog::SetOccDialogInfo
Menentukan templat untuk kotak dialog yang merupakan kontainer kontrol OLE.
virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);
Parameter
pOccDialogInfo
[di] Penunjuk ke templat kotak dialog yang digunakan untuk membuat objek kotak dialog. Nilai parameter ini kemudian diteruskan ke metode COccManager::CreateDlgControls .
Tampilkan Nilai
Selalu BENAR.
Keterangan
Metode ini mendukung kelas COccManager , yang mengelola situs kontrol OLE dan kontrol ActiveX. Struktur _AFX_OCC_DIALOG_INFO ditentukan dalam file header afxocc.h.