Kelas CPaneDialog

Nota

Pustaka Microsoft Foundation Classes (MFC) terus didukung. Namun, kami tidak lagi menambahkan fitur atau memperbarui dokumentasi.

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

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CPaneDialog

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.

Lihat juga

Bagan Hierarki
Kelas
Kelas CDockablePane
Gaya Jendela