Kelas CBasePane

Kelas dasar untuk semua panel di MFC.

Sintaks

class CBasePane : public CWnd

Anggota

Konstruktor Publik

Nama	Deskripsi
CBasePane::CBasePane	Konstruktor default.
CBasePane::~CBasePane	Destruktor.

Metode Publik

Nama	Deskripsi
CBasePane::accHitTest	Dipanggil oleh kerangka kerja untuk mengambil elemen turunan atau objek turunan pada titik tertentu di layar. (Penimpaan CWnd::accHitTest.)
CBasePane::accLocation	Dipanggil oleh kerangka kerja untuk mengambil lokasi layar saat ini untuk objek yang ditentukan. (Penimpaan CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent	CBasePane tidak menggunakan metode ini.
CBasePane::accSelect	Dipanggil oleh kerangka kerja untuk mengubah pilihan atau memindahkan fokus keyboard dari objek yang ditentukan. (Penimpaan CWnd::accSelect.)
CBasePane::AddPane	Menambahkan panel ke manajer docking.
CBasePane::AdjustDockingLayout	Mengalihkan panggilan ke manajer docking untuk menyesuaikan tata letak docking.
CBasePane::AdjustLayout	Dipanggil oleh kerangka kerja saat panel harus menyesuaikan tata letak internalnya.
CBasePane::CalcFixedLayout	Menghitung ukuran horizontal bilah kontrol.
CBasePane::CanAcceptPane	Menentukan apakah panel lain dapat ditampung ke panel.
CBasePane::CanAutoHide	Menentukan apakah panel mendukung mode sembunyikan otomatis.
CBasePane::CanBeAttached	Menentukan apakah panel dapat ditampung ke panel lain.
CBasePane::CanBeClosed	Menentukan apakah panel dapat ditutup.
CBasePane::CanBeDocked	Menentukan apakah panel dapat ditampung ke panel lain.
CBasePane::CanBeResized	Menentukan apakah panel dapat diubah ukurannya.
CBasePane::CanBeTabbedDocument	Menentukan apakah panel dapat dikonversi ke dokumen bertab MDI.
CBasePane::CanFloat	Menentukan apakah panel dapat mengambang.
CBasePane::CanFocus	Menentukan apakah panel dapat menerima fokus.
CBasePane::CopyState	Menyalin status panel tertentu.
CBasePane::CreateDefaultMiniframe	Jika panel dapat mengambang, buat jendela bingkai mini.
CBasePane::CreateEx	Membuat kontrol panel.
CBasePane::D ockPane	Menambungkan panel ke panel lain atau ke jendela bingkai.
CBasePane::D ockPaneUsingRTTI	Menambah panel dengan menggunakan informasi jenis run-time.
CBasePane::D ockToFrameWindow	Menambak panel yang dapat ditambat ke bingkai.
CBasePane::D oesAllowDynInsertBefore	Menentukan apakah panel lain dapat disisipkan secara dinamis antara panel ini dan bingkai induk.
CBasePane::EnableDocking	Memungkinkan docking panel ke bingkai utama.
CBasePane::EnableGripper	Mengaktifkan atau menonaktifkan gripper. Jika gripper diaktifkan, pengguna dapat menyeretnya untuk memposisikan ulang panel.
CBasePane::FillWindowRect	Digunakan secara internal.
CBasePane::FloatPane	Mengambangkan panel.
CBasePane::get_accChild	Dipanggil oleh kerangka kerja untuk mengambil alamat IDispatch antarmuka untuk anak yang ditentukan. (Penimpaan CWnd::get_accChild.)
CBasePane::get_accChildCount	Dipanggil oleh kerangka kerja untuk mengambil jumlah anak yang termasuk dalam objek ini. (Penimpaan CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction	Dipanggil oleh kerangka kerja untuk mengambil string yang menjelaskan tindakan default untuk objek. (Penimpaan CWnd::get_accDefaultAction.)
CBasePane::get_accDescription	Dipanggil oleh kerangka kerja untuk mengambil string yang menjelaskan tampilan visual objek yang ditentukan. (Penimpaan CWnd::get_accDescription.)
CBasePane::get_accFocus	Dipanggil oleh kerangka kerja untuk mengambil objek yang memiliki fokus keyboard. (Penimpaan CWnd::get_accFocus.)
CBasePane::get_accHelp	Dipanggil oleh kerangka kerja untuk mengambil string properti Bantuan untuk objek. (Penimpaan CWnd::get_accHelp.)
CBasePane::get_accHelpTopic	Dipanggil oleh kerangka kerja untuk mengambil jalur lengkap file WinHelp yang terkait dengan objek yang ditentukan dan pengidentifikasi topik yang sesuai dalam file tersebut. (Penimpaan CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut	Dipanggil oleh kerangka kerja untuk mengambil kunci pintasan yang ditentukan untuk objek. (Penimpaan CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName	Dipanggil oleh kerangka kerja untuk mengambil nama objek yang ditentukan. (Penimpaan CWnd::get_accName.)
CBasePane::get_accParent	Dipanggil oleh kerangka kerja untuk mengambil IDispatch antarmuka untuk induk objek. (Penimpaan CWnd::get_accParent.)
CBasePane::get_accRole	Dipanggil oleh kerangka kerja untuk mengambil informasi yang menjelaskan peran objek yang ditentukan. (Penimpaan CWnd::get_accRole.)
CBasePane::get_accSelection	Dipanggil oleh kerangka kerja untuk mengambil anak terpilih dari objek ini. (Penimpaan CWnd::get_accSelection.)
CBasePane::get_accState	Dipanggil oleh kerangka kerja untuk mengambil status objek yang ditentukan saat ini. (Penimpaan CWnd::get_accState.)
CBasePane::get_accValue	Dipanggil oleh kerangka kerja untuk mengambil nilai objek yang ditentukan. (Penimpaan CWnd::get_accValue.)
CBasePane::GetCaptionHeight	Mengembalikan tinggi keterangan.
CBasePane::GetControlBarStyle	Mengembalikan gaya bilah kontrol.
CBasePane::GetCurrentAlignment	Mengembalikan perataan panel saat ini.
CBasePane::GetDockingMode	Mengembalikan mode docking saat ini untuk panel.
CBasePane::GetDockSiteFrameWnd	Mengembalikan penunjuk ke jendela yang merupakan situs dock untuk panel.
CBasePane::GetEnabledAlignment	Mengembalikan gaya CBRS_ALIGN_ yang diterapkan ke panel.
CBasePane::GetMFCStyle	Mengembalikan gaya panel khusus untuk MFC.
CBasePane::GetPaneIcon	Mengembalikan handel ke ikon panel.
CBasePane::GetPaneRect	Digunakan secara internal.
CBasePane::GetPaneRow	Mengembalikan penunjuk ke objek CDockingPanesRowtempat panel ditambatkan.
CBasePane::GetPaneStyle	Mengembalikan gaya panel.
CBasePane::GetParentDockSite	Mengembalikan penunjuk ke situs dock induk.
CBasePane::GetParentMiniFrame	Mengembalikan penunjuk ke jendela bingkai mini induk.
CBasePane::GetParentTabbedPane	Mengembalikan penunjuk ke panel bertab induk.
CBasePane::GetParentTabWnd	Mengembalikan penunjuk ke jendela induk yang berada di dalam tab.
CBasePane::GetRecentVisibleState	Kerangka kerja memanggil metode ini saat panel dipulihkan dari arsip.
CBasePane::HideInPrintPreviewMode	Menentukan apakah panel disembunyikan dalam pratinjau cetak.
CBasePane::InsertPane	Mendaftarkan panel yang ditentukan dengan manajer docking.
CBasePane::IsAccessibilityCompatible	Menentukan apakah panel mendukung Aksesibilitas Aktif.
CBasePane::IsAutoHideMode	Menentukan apakah panel berada dalam mode sembunyikan otomatis.
CBasePane::IsDialogControl	Menentukan apakah panel adalah kontrol dialog.
CBasePane::IsDocked	Menentukan apakah panel ditampung.
CBasePane::IsFloating	Menentukan apakah panel mengambang.
CBasePane::IsHorizontal	Menentukan apakah panel ditampung secara horizontal.
CBasePane::IsInFloatingMultiPaneFrameWnd	Menentukan apakah panel berada di jendela bingkai multi-panel.
CBasePane::IsMDITabbed	Menentukan apakah panel telah ditambahkan ke jendela anak MDI sebagai dokumen bertab.
CBasePane::IsPaneVisible	Menentukan apakah bendera WS_VISIBLE diatur untuk panel.
CBasePane::IsPointNearDockSite	Menentukan apakah titik yang ditentukan berada di dekat situs dok.
CBasePane::IsResizable	Menentukan apakah panel dapat diubah ukurannya.
CBasePane::IsRestoredFromRegistry	Menentukan apakah panel dipulihkan dari registri.
CBasePane::IsTabbed	Menentukan apakah panel telah disisipkan dalam kontrol tab jendela bertab.
CBasePane::IsTooltipTopmost	Digunakan secara internal.
CBasePane::IsVisible	Menentukan apakah panel terlihat.
CBasePane::LoadState	Memuat status panel dari registri.
CBasePane::MoveWindow	Memindahkan panel.
CBasePane::OnAfterChangeParent	Dipanggil oleh kerangka kerja saat induk panel telah diubah.
CBasePane::OnBeforeChangeParent	Dipanggil oleh kerangka kerja tepat sebelum panel mengubah jendela induknya.
CBasePane::OnDrawCaption	Kerangka kerja memanggil metode ini ketika keterangan digambar.
CBasePane::OnMovePaneDivider	Metode ini saat ini tidak digunakan.
CBasePane::OnPaneContextMenu	Dipanggil oleh kerangka kerja saat membangun menu yang memiliki daftar panel.
CBasePane::OnRemoveFromMiniFrame	Dipanggil oleh kerangka kerja saat panel dihapus dari jendela bingkai mini induknya.
CBasePane::OnSetAccData	CBasePane tidak menggunakan metode ini.
CBasePane::OnUpdateCmdUI	Digunakan secara internal.
CBasePane::P aneFromPoint	Mengembalikan panel yang berisi titik yang diberikan.
CBasePane::PreTranslateMessage	Digunakan oleh CWinApp kelas untuk menerjemahkan pesan jendela sebelum dikirim ke fungsi Windows TranslateMessage dan DispatchMessage. (Penimpaan CWnd::P reTranslateMessage.)
CBasePane::RecalcLayout	CBasePane tidak menggunakan metode ini.
CBasePane::RemovePaneFromDockManager	Membatalkan pendaftaran panel dan menghapusnya dari daftar di manajer docking.
CBasePane::SaveState	Menyimpan status panel ke registri.
CBasePane::SelectDefaultFont	Memilih font default untuk konteks perangkat tertentu.
CBasePane::Serialize	Membaca atau menulis objek ini dari atau ke arsip. (Penimpaan CObject::Serialize.)
CBasePane::SetControlBarStyle	Mengatur gaya bilah kontrol.
CBasePane::SetDockingMode	Mengatur mode docking untuk panel.
CBasePane::SetMDITabbed	Digunakan secara internal.
CBasePane::SetPaneAlignment	Mengatur perataan untuk panel.
CBasePane::SetPaneRect	Digunakan secara internal.
CBasePane::SetPaneStyle	Mengatur gaya panel.
CBasePane::SetRestoredFromRegistry	Digunakan secara internal.
CBasePane::SetWindowPos	Mengubah ukuran, posisi, dan urutan Z panel.
CBasePane::ShowPane	Memperlihatkan atau menyembunyikan panel.
CBasePane::StretchPane	Membentangkan panel secara vertikal atau horizontal.
CBasePane::UndockPane	Menghapus panel dari situs dock, slider default, atau jendela bingkai mini tempat panel tersebut saat ini ditambatkan.

Metode yang Dilindungi

Nama	Deskripsi
CBasePane::D oPaint	Mengisi latar belakang panel.

Keterangan

Jika Anda ingin membuat kelas panel yang mendukung fitur docking yang diperluas yang tersedia di MFC, Anda harus mendapatkannya dari CBasePane atau dari Kelas CPane.

Tips Kustomisasi

Tips penyesuaian berikut berkaitan dengan CBasePane Class dan kelas apa pun yang mewarisinya:

• Saat membuat panel, Anda bisa menerapkan beberapa gaya baru:

  • AFX_CBRS_FLOAT membuat panel mengambang.

  • AFX_CBRS_AUTOHIDE mengaktifkan mode sembunyikan otomatis.

  • AFX_CBRS_CLOSE memungkinkan panel ditutup (tersembunyi).

  Ini adalah bendera yang dapat Anda gabungkan dengan operasi bitwise-OR.

CBasePane menerapkan metode Boolean virtual berikut untuk mencerminkan bendera ini: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. Anda dapat mengambil alihnya dalam kelas turunan untuk menyesuaikan perilaku mereka.

• Anda dapat menyesuaikan perilaku docking dengan menimpa CBasePane::CanAcceptPane. Minta panel Anda mengembalikan FALSE dari metode ini untuk mencegah panel lain menambungkan ke dalamnya.

• Jika Anda ingin membuat panel statis yang tidak dapat mengambang dan yang mencegah panel lain menambatkan sebelum penambatan (mirip dengan bilah Outlook dalam contoh OutlookDemo), buat sebagai tidak mengambang dan menimpa CBasePane::D oesAllowDynInsertBefore untuk mengembalikan FALSE. Implementasi default mengembalikan FALSE jika panel dibuat tanpa gaya AFX_CBRS_FLOAT.

• Buat semua panel dengan ID selain -1.

• Untuk menentukan visibilitas panel, gunakan CBasePane::IsVisible. Ini menangani status visibilitas dengan benar dalam mode bertab dan sembunyikan otomatis.

• Jika Anda ingin membuat panel yang tidak dapat diubah bentuknya, buat tanpa gaya AFX_CBRS_FLOAT dan panggil CFrameWnd::D ockControlBar.

• Untuk mengecualikan panel dari tata letak docking atau untuk menghapus toolbar dari bilah doknya, panggil CBasePane::UndockPane. Jangan panggil metode ini untuk panel dalam mode sembunyikan otomatis atau untuk panel yang berada di tab jendela bertab.

• Jika Anda ingin mengambang atau membatalkan tambatan panel yang berada dalam mode sembunyikan otomatis, Anda harus memanggil CDockablePane::SetAutoHideMode dengan FALSE sebagai argumen pertama sebelum Anda memanggil CBasePane::FloatPane atau CBasePane::UndockPane.

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CBasePane kelas . Contoh menunjukkan cara mengambil panel dari CFrameWndEx kelas dan cara mengatur mode docking, perataan panel, dan gaya panel. Kodenya berasal dari sampel Word Pad.

// This CMainFrame class extends the CFrameWndEx class.
// GetPane is a method in the CFrameWndEx class which
// Returns a pointer to the pane that has the specified ID.
CBasePane *pBar = GetPane(ID_VIEW_FORMATBAR);
if (pBar != NULL)
{
    // Set the docking mode, the pane alignment, and the pane style.
    pBar->SetDockingMode(DT_STANDARD);
    pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
    pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
    pBar->ShowPane(TRUE, FALSE, FALSE);
}

Hierarki Warisan

CObject

CCmdTarget

CWnd

CBasePane

Persyaratan

Header: afxbasepane.h

CBasePane::AccNotifyObjectFocusEvent

CBasePane tidak menggunakan metode ini.

virtual void AccNotifyObjectFocusEvent(int);

Parameter

int
[in] Tidak digunakan.

CBasePane::AddPane

Menambahkan panel ke manajer docking.

void AddPane(CBasePane* pBar);

Parameter

pBar
[di] Penunjuk ke panel untuk ditambahkan.

Keterangan

Ini adalah metode kenyamanan yang menambahkan panel ke manajer docking. Dengan menggunakan metode ini, Anda tidak perlu menulis kode yang menganalisis jenis bingkai induk.

Untuk informasi selengkapnya, lihat Kelas CDockingManager dan CMDIFrameWndEx::AddPane.

CBasePane::AdjustDockingLayout

Mengalihkan panggilan ke manajer docking untuk menyesuaikan tata letak docking.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parameter

hdwp
[out] Handel ke struktur yang berisi beberapa posisi jendela.

Keterangan

Ini adalah metode kenyamanan yang menyesuaikan tata letak docking. Dengan menggunakan metode ini, Anda tidak perlu menulis kode yang menganalisis jenis bingkai induk.

Untuk informasi selengkapnya, lihat CDockingManager::AdjustDockingLayout

CBasePane::AdjustLayout

Dipanggil oleh kerangka kerja untuk menyesuaikan tata letak internal panel.

virtual void AdjustLayout();

Keterangan

Kerangka kerja memanggil metode ini ketika panel harus menyesuaikan tata letak internalnya. Implementasi dasar tidak melakukan apa pun.

CBasePane::CalcFixedLayout

Menghitung ukuran horizontal bilah kontrol.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameter

bStretch
[di] Menunjukkan apakah bilah harus direntangkan ke ukuran bingkai. Parameter bStretch bukan nol ketika bilah bukan bilah docking (tidak tersedia untuk docking) dan 0 ketika ditambatkan atau mengambang (tersedia untuk docking).

bHorz
[di] Menunjukkan bahwa bilah berorientasi horizontal atau vertikal. Parameter bHorz bukan nol jika bilah berorientasi horizontal dan berorientasi 0 jika berorientasi vertikal.

Tampilkan Nilai

Ukuran bilah kontrol, dalam piksel, objek CSize .

Keterangan

Lihat bagian keterangan di CControlBar::CalcFixedLayout

CBasePane::CanAcceptPane

Menentukan apakah panel lain dapat ditampung ke panel.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parameter

pBar
[di] Penunjuk ke panel untuk melakukan dock.

Tampilkan Nilai

TRUE jika panel lain dapat diterima; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini sebelum menambatkan panel yang ditentukan oleh pBar ke panel saat ini.

Gunakan metode ini dan metode CBasePane::CanBeDocked untuk mengontrol bagaimana panel merapat ke panel lain di aplikasi Anda.

Implementasi default mengembalikan FALSE.

CBasePane::CanAutoHide

Menentukan apakah panel mendukung mode sembunyikan otomatis.

virtual BOOL CanAutoHide() const;

Tampilkan Nilai

TRUE jika panel ini mendukung mode sembunyikan otomatis; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil fungsi ini untuk menentukan apakah panel mendukung mode sembunyikan otomatis.

Selama konstruksi, Anda dapat mengatur kemampuan ini dengan meneruskan bendera AFX_CBRS_AUTOHIDE ke CBasePane::CreateEx.

Implementasi default memeriksa bendera AFX_CBRS_AUTOHIDE. Ambil alih metode ini dalam kelas turunan untuk menyesuaikan perilaku ini.

CBasePane::CanBeAttached

Menentukan apakah panel dapat ditambatkan ke panel atau jendela bingkai lain.

virtual BOOL CanBeAttached() const;

Tampilkan Nilai

TRUE jika panel dapat ditambatkan ke panel atau jendela bingkai lain; jika tidak FALSE.

Keterangan

Implementasi default mengembalikan FALSE. Ambil alih metode ini di kelas turunan untuk mengaktifkan atau menonaktifkan kemampuan untuk menambatkan tanpa memanggil CBasePane::EnableDocking.

CBasePane::CanBeClosed

Menentukan apakah panel dapat ditutup.

virtual BOOL CanBeClosed() const;

Tampilkan Nilai

TRUE jika panel dapat ditutup; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah panel dapat ditutup. Jika metode mengembalikan TRUE, tombol Tutup ditambahkan ke bilah judul panel atau, jika panel mengambang, ke bilah judul jendela miniframe panel.

Selama konstruksi, Anda dapat mengatur kemampuan ini dengan meneruskan bendera AFX_CBRS_CLOSE ke CBasePane::CreateEx.

Implementasi default memeriksa bendera AFX_CBRS_CLOSE.

CBasePane::CanBeDocked

Menentukan apakah panel dapat ditampung ke panel lain.

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

Parameter

pDockBar
[di] Penunjuk ke panel lain.

Tampilkan Nilai

TRUE jika panel ini dapat ditampung ke panel lain; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini sebelum menambatkan panel yang ditentukan oleh pDockBar ke panel saat ini.

Gunakan metode ini dan metode CBasePane::CanAcceptPane untuk mengontrol bagaimana panel merapat ke panel lain di aplikasi Anda.

Implementasi default mengembalikan FALSE.

CBasePane::CanBeResized

Menentukan apakah panel dapat diubah ukurannya.

virtual BOOL CanBeResized() const;

Tampilkan Nilai

TRUE jika panel dapat diubah ukurannya; jika tidak, FALSE.

Keterangan

Metode ini memeriksa bendera AFX_CBRS_RESIZE, yang ditentukan secara default di CBasePane::OnCreate. Jika bendera ini tidak ditentukan, manajer docking menandai panel secara internal sebagai immovable alih-alih menambahkannya.

CBasePane::CanBeTabbedDocument

Menentukan apakah panel dapat dikonversi ke dokumen bertab MDI.

virtual BOOL CanBeTabbedDocument() const;

Tampilkan Nilai

TRUE jika panel dapat dikonversi ke dokumen bertab; jika tidak, FALSE. CBasePane::CanBeTabbedDocument selalu mengembalikan FALSE.

Keterangan

Hanya objek dari jenis -turunan tertentu CBasePane, seperti Kelas CDockablePane, yang dapat dikonversi ke dokumen bertab.

CBasePane::CanFloat

Menentukan apakah panel dapat mengambang.

virtual BOOL CanFloat() const;

Tampilkan Nilai

TRUE jika panel dapat mengambang; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah panel dapat mengambang.

Selama konstruksi, Anda dapat mengatur kemampuan ini dengan meneruskan bendera AFX_CBRS_FLOAT ke CBasePane::CreateEx.

Catatan

Kerangka kerja mengasumsikan bahwa panel non-floating statis dan status docking-nya tidak dapat berubah. Oleh karena itu, kerangka kerja tidak menyimpan status docking panel non-mengambang.

Implementasi default memeriksa gaya AFX_CBRS_FLOAT.

CBasePane::CanFocus

Menentukan apakah panel dapat menerima fokus.

virtual BOOL CanFocus() const;

Tampilkan Nilai

TRUE jika panel dapat menerima fokus; jika tidak FALSE.

Keterangan

Ambil alih metode ini dalam kelas turunan untuk mengontrol fokus. Misalnya, karena toolbar tidak dapat menerima fokus, metode ini mengembalikan FALSE saat dipanggil pada objek toolbar.

Kerangka kerja mencoba mengatur fokus input saat panel ditambatkan atau diambang.

CBasePane::CopyState

Menyalin status panel tertentu.

virtual void CopyState(CBasePane* pOrgBar);

Parameter

pOrgBar
[di] Penunjuk ke panel lain.

Keterangan

Metode ini menyalin status dari pOrgBar ke panel ini.

CBasePane::CreateDefaultMiniframe

Jika panel dapat mengambang, metode ini membuat jendela bingkai mini untuk itu.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parameter

rectInitial
[di] Menentukan koordinat awal jendela bingkai-mini.

Tampilkan Nilai

Penunjuk ke jendela bingkai mini baru atau NULL jika pembuatan gagal.

Keterangan

Kerangka kerja memanggil metode ini ketika panel beralih ke status mengambang. Metode membuat jendela bingkai-mini dan melampirkan panel ke jendela ini.

Implementasi default mengembalikan NULL.

CBasePane::CreateEx

Membuat kontrol panel.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle=0,
    CCreateContext* pContext=NULL);

Parameter

dwStyleEx
[di] Gaya yang diperluas (lihat CWnd::CreateEx untuk informasi selengkapnya).

lpszClassName
[di] Nama kelas jendela.

lpszWindowName
[di] Nama jendela.

dwStyle
[di] Gaya jendela (lihat CWnd::CreateEx).

rect
[di] Persegi panjang awal.

pParentWnd
[di] Penunjuk ke jendela induk.

Nid
[di] Menentukan ID panel. Pasti unik.

dwControlBarStyle
[di] Bendera gaya untuk panel.

pContext
[di] Penunjuk ke CcreateContext

Tampilkan Nilai

TRUE jika panel berhasil dibuat; jika tidak FALSE.

Keterangan

Membuat jendela kelas lpszClassName. Jika Anda menentukan WS_CAPTION, metode ini menghapus bit gaya WS_CAPTION dan diatur CBasePane::m_bHasCaption ke TRUE, karena pustaka tidak mendukung panel dengan keterangan.

Anda dapat menggunakan kombinasi gaya jendela anak dan gaya bilah kontrol MFC (CBRS_).

Pustaka menambahkan beberapa gaya baru untuk panel. Tabel berikut ini menjelaskan gaya baru:

Gaya	Deskripsi
AFX_CBRS_FLOAT	Panel dapat mengambang.
AFX_CBRS_AUTOHIDE	Panel mendukung mode sembunyikan otomatis
AFX_CBRS_RESIZE	Panel dapat diubah ukurannya. Penting: Gaya ini tidak diimplementasikan.
AFX_CBRS_CLOSE	Panel dapat ditutup.
AFX_CBRS_AUTO_ROLLUP	Panel dapat digulung saat mengambang.
AFX_CBRS_REGULAR_TABS	Saat satu panel menambungkan ke panel lain yang memiliki gaya ini, jendela bertab biasa dibuat. (Untuk informasi selengkapnya, lihat Kelas CTabbedPane.)
AFX_CBRS_OUTLOOK_TABS	Saat satu panel menambungkan ke panel lain yang memiliki gaya ini, jendela bertab gaya Outlook dibuat. (Untuk informasi selengkapnya, lihat Kelas CMFCOutlookBar.)

Untuk menggunakan gaya baru, tentukan di dwControlBarStyle.

CBasePane::D ockPane

Menambungkan panel ke panel lain atau ke jendela bingkai.

virtual BOOL DockPane(
    CBasePane* pDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Parameter

pDockBar
[di] Penunjuk ke panel lain.

lpRect
[di] Menentukan persegi tujuan.

dockMethod
[di] Menentukan metode docking.

Tampilkan Nilai

TRUE jika bilah kontrol berhasil di-dock; jika tidak, FALSE.

Keterangan

Panggil fungsi ini untuk menambatkan panel ke panel lain atau bilah dok ( Kelas CDockSite) yang ditentukan oleh pDockBar, atau ke bingkai utama jika pDockBar adalah NULL.

dockMethod menentukan bagaimana panel ditampar. Lihat CPane::D ockPane untuk daftar nilai yang mungkin.

CBasePane::D ockPaneUsingRTTI

Menambah panel dengan menggunakan informasi jenis run-time.

void DockPaneUsingRTTI(BOOL bUseDockSite);

Parameter

bUseDockSite
[di] Jika TRUE, dock ke situs docking. Jika FALSE, dock ke bingkai induk.

CBasePane::D ockToFrameWindow

Menambak panel yang dapat ditambat ke bingkai.

virtual BOOL DockToFrameWindow(
    DWORD dwAlignment,
    LPCRECT lpRect = NULL,
    DWORD dwDockFlags = DT_DOCK_LAST,
    CBasePane* pRelativeBar = NULL,
    int nRelativeIndex = -1,
    BOOL bOuterEdge = FALSE);

Parameter

dwAlignment
[di] Sisi bingkai induk yang ingin Anda dock panelnya.

lpRect
[di] Ukuran yang diinginkan.

dwDockFlags
[in] Diabaikan.

pRelativeBar
[in] Diabaikan.

nRelativeIndex
[in] Diabaikan.

bOuterEdge
[di] Jika TRUE dan ada panel lain yang dapat ditambatkan di sisi yang ditentukan oleh dwAlignment, panel ditambatkan di luar panel lain, lebih dekat ke tepi bingkai induk. Jika FALSE, panel ditampung lebih dekat ke tengah area klien.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Keterangan

Metode ini gagal jika pembagi panel ( Kelas CPaneDivider) tidak dapat dibuat. Jika tidak, itu selalu mengembalikan TRUE.

CBasePane::D oesAllowDynInsertBefore

Menentukan apakah panel lain dapat disisipkan secara dinamis antara panel ini dan bingkai induk.

virtual BOOL DoesAllowDynInsertBefore() const;

Tampilkan Nilai

TRUE jika pengguna dapat menyisipkan panel lain; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah pengguna dapat menyisipkan panel secara dinamis sebelum panel ini.

Misalnya, aplikasi Anda membuat panel yang ditambatkan di sisi kiri bingkai (seperti bilah Outlook). Untuk mencegah pengguna menambungkan panel lain di sebelah kiri panel pertama, ambil alih metode ini dan kembalikan FALSE.

Kami menyarankan agar Anda mengambil alih metode ini dan mengembalikan FALSE untuk panel non-mengambang yang berasal dari Kelas CDockablePane.

Implementasi default mengembalikan TRUE.

CBasePane::D oPaint

Mengisi latar belakang panel.

virtual void DoPaint(CDC* pDC);

Parameter

Pdc
[di] Penunjuk ke konteks perangkat.

Keterangan

Implementasi default memanggil manajer visual saat ini untuk mengisi latar belakang ( CMFCVisualManager::OnFillBarBackground).

CBasePane::EnableDocking

Memungkinkan docking panel ke bingkai utama.

virtual void EnableDocking(DWORD dwAlignment);

Parameter

dwAlignment
[di] Menentukan perataan docking untuk diaktifkan.

Keterangan

Panggil metode ini untuk mengaktifkan perataan docking ke bingkai utama. Anda dapat meneruskan kombinasi bendera CBRS_ALIGN_ (untuk informasi selengkapnya, lihat CControlBar::EnableDocking).

EnableDocking mengatur bendera CBasePane::m_dwEnabledAlignment internal dan kerangka kerja memeriksa bendera ini saat panel ditambatkan.

Panggil CBasePane::GetEnabledAlignment untuk menentukan perataan docking untuk panel.

CBasePane::EnableGripper

Mengaktifkan atau menonaktifkan gripper. Jika gripper diaktifkan, pengguna dapat menyeretnya untuk memposisikan ulang panel.

virtual void EnableGripper(BOOL bEnable);

Parameter

bEnable
[di] TRUE untuk mengaktifkan gripper; FALSE untuk menonaktifkannya.

Keterangan

Kerangka kerja menggunakan metode ini untuk mengaktifkan gripper alih-alih menggunakan gaya WS_CAPTION.

CBasePane::FloatPane

Mengambangkan panel.

virtual BOOL FloatPane(
    CRect rectFloat,
    AFX_DOCK_METHOD dockMethod=DM_UNKNOWN,
    bool bShow=true);

Parameter

rectFloat
[di] Menentukan koordinat layar tempat panel mengambang muncul.

dockMethod
[di] Menentukan metode dock yang akan digunakan untuk mengambangkan panel.

bShow
[di] Menentukan apakah panel mengambang terlihat (TRUE) atau tersembunyi (FALSE).

Tampilkan Nilai

TRUE jika panel berhasil mengambang; jika tidak FALSE.

Keterangan

Panggil metode ini untuk mengambangkan panel pada posisi layar yang ditentukan oleh rectFloat.

CBasePane::get_accHelpTopic

Kerangka kerja memanggil metode ini untuk mengambil jalur lengkap file WinHelp yang terkait dengan objek yang ditentukan dan pengidentifikasi topik yang sesuai dalam file tersebut.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parameter

pszHelpFile
[di] Alamat BSTR yang menerima jalur lengkap file WinHelp yang terkait dengan objek yang ditentukan, jika ada.

varChild
[di] Menentukan apakah topik Bantuan yang akan diambil adalah objek atau salah satu elemen turunan objek. Parameter ini dapat berupa CHILDID_SELF (untuk mendapatkan topik Bantuan untuk objek) atau ID anak (untuk mendapatkan topik Bantuan untuk salah satu elemen turunan objek).

pidTopic
[di] Mengidentifikasi topik file Bantuan yang terkait dengan objek yang ditentukan.

Tampilkan Nilai

CBasePane tidak menerapkan metode ini. Oleh karena itu, CBasePane::get_accHelpTopic selalu mengembalikan S_FALSE.

Keterangan

Fungsi ini adalah bagian dari dukungan Aksesibilitas Aktif di MFC. Ambil alih fungsi ini di kelas turunan untuk memberikan informasi bantuan tentang objek Anda.

CBasePane::get_accSelection

Kerangka kerja memanggil metode ini untuk mengambil anak terpilih dari objek ini.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parameter

pvarChildren
[di] Menerima informasi yang mengidentifikasi anak yang dipilih.

Tampilkan Nilai

CBasePane tidak menerapkan metode ini. Jika pvarChildren ADALAH NULL, metode ini mengembalikan E_INVALIDARG. Jika tidak, metode ini mengembalikan DISP_E_MEMBERNOTFOUND.

Keterangan

Fungsi ini adalah bagian dari dukungan Aksesibilitas Aktif di MFC. Ambil alih fungsi ini di kelas turunan jika Anda memiliki elemen antarmuka pengguna yang tidak berjendela selain kontrol ActiveX tanpa jendela.

CBasePane::GetCaptionHeight

Mengembalikan tinggi keterangan.

virtual int GetCaptionHeight() const;

Tampilkan Nilai

Tinggi keterangan.

CBasePane::GetControlBarStyle

Mengembalikan gaya bilah kontrol.

virtual DWORD GetControlBarStyle() const

Tampilkan Nilai

Kombinasi bitwise-OR dari bendera AFX_CBRS_.

Keterangan

Nilai yang dikembalikan adalah kombinasi dari kemungkinan nilai berikut.

Gaya	Deskripsi
AFX_CBRS_FLOAT	Membuat bilah kontrol mengapung.
AFX_CBRS_AUTOHIDE	Mengaktifkan mode sembunyikan otomatis.
AFX_CBRS_RESIZE	Mengaktifkan perubahan ukuran bilah kontrol. Saat bendera ini diatur, bilah kontrol dapat ditempatkan di panel yang dapat ditampung.
AFX_CBRS_CLOSE	Memungkinkan persembunyian bilah kontrol.

CBasePane::GetCurrentAlignment

Mengembalikan perataan panel saat ini.

virtual DWORD GetCurrentAlignment() const;

Tampilkan Nilai

Perataan bilah kontrol saat ini. Tabel berikut ini memperlihatkan nilai yang mungkin terjadi:

Nilai	Penjajaran
CBRS_ALIGN_LEFT	Perataan kiri.
CBRS_ALIGN_RIGHT	Perataan kanan.
CBRS_ALIGN_TOP	Perataan atas.
CBRS_ALIGN_BOTTOM	Perataan bawah.

CBasePane::GetDockingMode

Mengembalikan mode docking saat ini untuk panel.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Tampilkan Nilai

DT_STANDARD jika menyeret panel ditunjukkan pada layar dengan persegi panjang seret. DT_IMMEDIATE jika konten panel diseret.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan mode docking panel saat ini.

Jika CBasePane::m_dockMode tidak ditentukan (DT_UNDEFINED), maka mode docking diambil dari mode docking global (AFX_GLOBAL_DATA::m_dockModeGlobal).

Dengan mengatur m_dockMode atau menimpa GetDockingMode , Anda dapat mengontrol mode docking untuk setiap panel.

CBasePane::GetDockSiteFrameWnd

Mengembalikan penunjuk ke objek CDockingPanesRowtempat panel ditambatkan.

virtual CWnd* GetDockSiteFrameWnd() const;

Tampilkan Nilai

Penunjuk ke situs dock panel.

Keterangan

Panggil metode ini untuk mengambil penunjuk ke situs dock panel. Situs dok dapat berupa jendela bingkai utama jika panel ditambatkan ke bingkai utama, atau jendela bingkai mini jika panel mengambang.

CBasePane::GetEnabledAlignment

Mengembalikan gaya CBRS_ALIGN_ yang diterapkan ke panel.

virtual DWORD GetEnabledAlignment() const;

Tampilkan Nilai

Kombinasi gaya CBRS_ALIGN_. Tabel berikut ini memperlihatkan kemungkinan gaya:

Bendera	Perataan yang diaktifkan
CBRS_ALIGN_LEFT	Kiri.
CBRS_ALIGN_RIGHT	Betul.
CBRS_ALIGN_TOP	Atas.
CBRS_ALIGN_BOTTOM	Bawah.
CBRS_ALIGN_ANY	Kombinasi semua bendera.

Keterangan

Panggil metode ini untuk menentukan perataan yang diaktifkan untuk panel. Perataan yang diaktifkan berarti sisi jendela bingkai utama tempat panel dapat ditambatkan.

Aktifkan perataan docking dengan menggunakan CBasePane::EnableDocking.

CBasePane::GetMFCStyle

Mengembalikan gaya panel yang khusus untuk MFC.

virtual DWORD GetMFCStyle() const;

Tampilkan Nilai

Kombinasi gaya panel khusus pustaka (AFX_CBRS_).

CBasePane::GetPaneIcon

Mengembalikan handel ke ikon panel.

virtual HICON GetPaneIcon(BOOL bBigIcon);

Parameter

bBigIcon
[di] Menentukan ikon 32 piksel dengan 32 piksel jika TRUE; menentukan ikon 16 piksel dengan 16 piksel jika FALSE.

Tampilkan Nilai

Handel ke ikon panel. Jika tidak berhasil, mengembalikan NULL.

Keterangan

Implementasi default memanggil CWnd::GetIcon.

CBasePane::GetPaneRow

Mengembalikan penunjuk ke objek CDockingPanesRowtempat panel ditambatkan.

CDockingPanesRow* GetPaneRow();

Tampilkan Nilai

Penunjuk ke CDockingPanesRow jika panel ditambah, atau NULL jika mengambang.

Keterangan

Panggil metode ini untuk mengakses baris tempat panel ditampar. Misalnya, untuk mengatur panel di baris tertentu, panggil GetPaneRow lalu panggil CDockingPanesRow::ArrangePanes.

CBasePane::GetPaneStyle

Mengembalikan gaya panel.

virtual DWORD GetPaneStyle() const;

Tampilkan Nilai

Kombinasi gaya bilah kontrol (termasuk gaya CBRS_) yang diatur oleh metode CBasePane::SetPaneStyle pada waktu pembuatan.

CBasePane::GetParentDockSite

Mengembalikan penunjuk ke situs dock induk.

virtual CDockSite* GetParentDockSite() const;

Tampilkan Nilai

Situs dok induk.

CBasePane::GetParentMiniFrame

Mengembalikan penunjuk ke jendela bingkai mini induk.

virtual CPaneFrameWnd* GetParentMiniFrame(BOOL bNoAssert=FALSE) const;

Parameter

bNoAssert
[di] Jika TRUE, metode ini tidak memeriksa penunjuk yang tidak valid. Jika Anda memanggil metode ini saat aplikasi Anda keluar, atur parameter ini ke TRUE.

Tampilkan Nilai

Penunjuk yang valid ke jendela bingkai mini induk jika panel mengambang; jika tidak, NULL.

Keterangan

Panggil fungsi ini untuk mengambil penunjuk ke jendela bingkai mini induk. Metode ini melakukan iterasi melalui semua orang tua dan memeriksa objek yang berasal dari Kelas CPaneFrameWnd.

Gunakan GetParentMiniFrame untuk menentukan apakah panel mengambang.

CBasePane::GetParentTabbedPane

Mengembalikan penunjuk ke panel bertab induk.

CBaseTabbedPane* GetParentTabbedPane() const;

Tampilkan Nilai

Penunjuk ke panel bertab induk jika ada; jika tidak, NULL.

CBasePane::GetParentTabWnd

Mengembalikan penunjuk ke jendela induk yang berada di dalam tab.

CMFCBaseTabCtrl* GetParentTabWnd(HWND& hWndTab) const;

Parameter

hWndTab
[out] Jika nilai yang dikembalikan bukan NULL, parameter ini berisi handel ke jendela bertab induk.

Tampilkan Nilai

Penunjuk yang valid ke jendela bertab induk atau NULL.

Keterangan

Gunakan fungsi ini untuk mengambil penunjuk ke jendela bertab induk. Terkadang tidak cukup untuk memanggil GetParent, karena panel mungkin berada di dalam pembungkus docking ( Kelas CDockablePaneAdapter) atau di dalam adaptor panel ( Kelas CDockablePaneAdapter). Dengan menggunakan GetParentTabWnd Anda akan dapat mengambil penunjuk yang valid dalam kasus tersebut (dengan asumsi bahwa induk adalah jendela bertab).

CBasePane::GetRecentVisibleState

Kerangka kerja memanggil metode ini saat panel dipulihkan dari arsip.

virtual BOOL GetRecentVisibleState() const;

Tampilkan Nilai

BOOL yang menentukan status yang terlihat baru-baru ini. Jika TRUE, panel terlihat saat diserialisasikan dan harus terlihat saat dipulihkan. Jika FALSE, panel disembunyikan saat diserialisasikan dan harus disembunyikan saat dipulihkan.

CBasePane::HideInPrintPreviewMode

Menentukan apakah panel disembunyikan dalam pratinjau cetak.

virtual BOOL HideInPrintPreviewMode() const;

Tampilkan Nilai

TRUE jika panel tidak ditampilkan dalam pratinjau cetak; jika tidak, FALSE.

Keterangan

Panel dasar tidak ditampilkan dalam pratinjau cetak. Oleh karena itu, metode ini selalu mengembalikan TRUE.

CBasePane::InsertPane

Mendaftarkan panel yang ditentukan dengan manajer docking.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Parameter

pControlBar
[di] Penunjuk ke panel untuk disisipkan.

pTarget
[di] Penunjuk ke panel yang berdekatan.

bAfter
[di] Jika TRUE, pControlBar dimasukkan setelah pTarget. Jika FALSE, pControlBar dimasukkan sebelum pTarget.

Tampilkan Nilai

TRUE jika metode berhasil, FALSE sebaliknya.

CBasePane::IsAccessibilityCompatible

Menentukan apakah panel mendukung Aksesibilitas Aktif.

virtual BOOL IsAccessibilityCompatible();

Tampilkan Nilai

TRUE jika panel mendukung Aksesibilitas Aktif; jika tidak, FALSE.

CBasePane::IsAutoHideMode

Menentukan apakah panel berada dalam mode sembunyikan otomatis.

virtual BOOL IsAutoHideMode() const;

Tampilkan Nilai

TRUE jika panel dalam mode sembunyikan otomatis; jika tidak, FALSE.

Keterangan

Panel dasar tidak dapat menyembunyikan secara otomatis. Metode ini selalu mengembalikan FALSE.

CBasePane::IsDialogControl

Menentukan apakah panel adalah kontrol kotak dialog.

BOOL IsDialogControl() const;

Tampilkan Nilai

TRUE jika panel adalah kontrol kotak dialog; jika tidak, FALSE.

Keterangan

Kerangka kerja menggunakan metode ini untuk memastikan konsistensi tata letak untuk semua panel.

CBasePane::IsDocked

Menentukan apakah panel ditampung.

virtual BOOL IsDocked() const;

Tampilkan Nilai

TRUE jika induk panel bukan bingkai mini atau jika panel mengambang dalam bingkai mini dengan panel lain; jika tidak, FALSE.

CBasePane::IsFloating

Menentukan apakah panel mengambang.

virtual BOOL IsFloating() const;

Tampilkan Nilai

TRUE jika panel mengambang; jika tidak, FALSE.

Keterangan

Metode ini mengembalikan nilai yang berlawanan dari CBasePane::IsDocked.

CBasePane::IsHorizontal

Menentukan apakah panel ditampung secara horizontal.

virtual BOOL IsHorizontal() const;

Tampilkan Nilai

TRUE jika panel ditampar secara horizontal; jika tidak FALSE.

Keterangan

Implementasi default memeriksa perataan docking saat ini untuk CBRS_ORIENT_HORZ.

CBasePane::IsInFloatingMultiPaneFrameWnd

Menentukan apakah panel berada di jendela bingkai multi-panel ( Kelas CMultiPaneFrameWnd).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Tampilkan Nilai

TRUE jika panel berada di jendela bingkai multi-panel; jika tidak, FALSE.

Keterangan

Hanya panel yang dapat ditambat yang dapat mengambang di jendela bingkai multi-panel. Oleh karena itu, CBasePane::IsInFloatingMultiPaneFrameWnd selalu mengembalikan FALSE.

CBasePane::IsMDITabbed

Menentukan apakah panel telah ditambahkan ke jendela anak MDI sebagai dokumen bertab.

virtual BOOL IsMDITabbed() const;

Tampilkan Nilai

TRUE jika panel ditambahkan ke jendela anak MDI sebagai dokumen bertab; jika tidak, FALSE.

CBasePane::IsPaneVisible

Menentukan apakah bendera WS_VISIBLE diatur untuk panel.

BOOL IsPaneVisible() const;

Tampilkan Nilai

TRUE jika WS_VISIBLE diatur; jika tidak, FALSE.

Keterangan

Gunakan CBasePane::IsVisible untuk menentukan visibilitas panel.

CBasePane::IsPointNearDockSite

Menentukan apakah titik yang ditentukan berada di dekat situs dok.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parameter

Titik
[di] Titik yang ditentukan.

dwBarAlignment
[out] Menentukan tepi mana yang titiknya dekat. Nilai yang mungkin CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP, dan CBRS_ALIGN_BOTTOM

bOuterEdge
[out] TRUE jika titik berada di dekat batas luar situs dok; FALSE jika tidak.

Tampilkan Nilai

TRUE jika titik berada di dekat situs dok; jika tidak FALSE.

Keterangan

Titik berada di dekat situs dok ketika berada dalam sensitivitas yang ditetapkan di manajer docking. Sensitivitas default adalah 15 piksel.

CBasePane::IsResizable

Menentukan apakah panel dapat diubah ukurannya.

virtual BOOL IsResizable() const;

Tampilkan Nilai

TRUE jika panel dapat diubah ukurannya oleh pengguna; jika tidak, FALSE.

Keterangan

Panel Kelas CDockablePane dapat diubah ukurannya.

Bilah status ( Kelas CMFCStatusBar) dan bilah dok ( Kelas CDockSite) tidak dapat diubah ukurannya.

CBasePane::IsRestoredFromRegistry

Menentukan apakah panel dipulihkan dari registri.

virtual BOOL IsRestoredFromRegistry() const;

Tampilkan Nilai

TRUE jika panel dipulihkan dari registri; jika tidak, FALSE.

CBasePane::IsTabbed

Menentukan apakah panel telah disisipkan dalam kontrol tab jendela bertab.

virtual BOOL IsTabbed() const;

Tampilkan Nilai

TRUE jika bilah kontrol disisipkan dalam tab jendela bertab; jika tidak FALSE.

Keterangan

Metode ini mengambil penunjuk ke induk langsung dan menentukan apakah kelas runtime induk adalah Kelas CMFCBaseTabCtrl.

CBasePane::IsVisible

Menentukan apakah panel terlihat.

virtual BOOL IsVisible() const;

Tampilkan Nilai

TRUE jika panel terlihat; jika tidak FALSE.

Keterangan

Gunakan metode ini untuk menentukan visibilitas panel. Jangan gunakan ::IsWindowVisible.

Jika panel tidak ditab (lihat CBasePane::IsTabbed), metode ini memeriksa gaya WS_VISIBLE. Jika panel ditab, metode ini memeriksa visibilitas jendela bertab induk. Jika jendela induk terlihat, fungsi memeriksa visibilitas tab panel menggunakan CMFCBaseTabCtrl::IsTabVisible.

CBasePane::LoadState

Memuat status panel dari registri.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[di] Nama profil.

nIndex
[di] Indeks profil.

uiID
[di] ID Panel.

Tampilkan Nilai

TRUE jika status panel berhasil dimuat; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini untuk memuat status panel dari registri. Ambil alih di kelas turunan untuk memuat informasi tambahan yang disimpan oleh CBasePane::SaveState.

CBasePane::MoveWindow

Memindahkan panel.

virtual HDWP MoveWindow(
    CRect& rect,
    BOOL bRepaint = TRUE,
    HDWP hdwp = NULL);

Parameter

rect
[di] Persegi panjang yang menentukan lokasi dan ukuran panel baru.

bRepaint
[di] Jika TRUE, panel dicat ulang. Jika FALSE, panel tidak dicat ulang.

hdwp
[di] Tangani ke struktur posisi jendela yang ditangguhkan.

Tampilkan Nilai

Handel ke struktur posisi jendela yang ditangguhkan, atau NULL.

Keterangan

Jika Anda meneruskan NULL sebagai parameter hdwp , metode ini akan memindahkan jendela secara normal. Jika Anda meneruskan handel, metode ini akan melakukan pemindahan jendela yang ditangguhkan. Anda dapat memperoleh handel dengan memanggil BeginDeferWindowPos atau dengan menyimpan nilai pengembalian panggilan sebelumnya ke metode ini.

CBasePane::OnAfterChangeParent

Dipanggil oleh kerangka kerja setelah induk panel berubah.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parameter

pWndOldParent
[di] Penunjuk ke induk sebelumnya.

Keterangan

Kerangka kerja memanggil metode ini setelah induk panel berubah, biasanya karena operasi docking atau floating.

Implementasi default tidak melakukan apa pun.

CBasePane::OnBeforeChangeParent

Dipanggil oleh kerangka kerja tepat sebelum panel mengubah jendela induknya.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay=FALSE);

Parameter

pWndNewParent
[di] Penunjuk ke jendela induk baru.

bDelay
[di] Menentukan apakah penyesuaian tata letak harus tertunda.

Keterangan

Kerangka kerja memanggil metode ini tepat sebelum induk panel berubah, biasanya karena operasi docking, floating, atau auto-hide.

Implementasi default tidak melakukan apa pun.

CBasePane::OnDrawCaption

Kerangka kerja memanggil metode ini ketika keterangan digambar.

virtual void OnDrawCaption();

Keterangan

Metode ini tidak memiliki fungsionalitas untuk CBasePane kelas .

CBasePane::OnMovePaneDivider

Metode ini saat ini tidak digunakan.

virtual void OnMovePaneDivider(CPaneDivider* /* unused */);

Parameter

Tidak terpakai
[in] Tidak digunakan.

CBasePane::OnPaneContextMenu

Dipanggil oleh kerangka kerja saat membangun menu yang memiliki daftar panel.

virtual void OnPaneContextMenu(
    CWnd* pParentFrame,
    CPoint point);

Parameter

pParentFrame
[di] Penunjuk ke bingkai induk.

Titik
[di] Menentukan lokasi menu pintasan.

Keterangan

OnPaneContextMenu memanggil manajer docking, yang mempertahankan daftar panel yang termasuk dalam jendela bingkai saat ini. Metode ini menambahkan nama panel ke menu pintasan dan menampilkannya. Perintah pada menu memperlihatkan atau menyembunyikan masing-masing panel.

Ambil alih metode ini untuk menyesuaikan perilaku ini.

CBasePane::OnRemoveFromMiniFrame

Dipanggil oleh kerangka kerja saat panel dihapus dari jendela bingkai mini induknya.

virtual void OnRemoveFromMiniFrame(CPaneFrameWnd* pMiniFrame);

Parameter

pMiniFrame
[di] Penunjuk ke jendela bingkai mini tempat panel dihapus.

Keterangan

Kerangka kerja memanggil metode ini ketika panel dihapus dari jendela bingkai mini induknya (sebagai akibat dari docking, misalnya).

Implementasi default tidak melakukan apa pun.

CBasePane::OnSetAccData

CBasePane tidak menggunakan metode ini.

virtual BOOL OnSetAccData(long lVal);

Parameter

lVal
[in] Tidak digunakan.

Tampilkan Nilai

Metode ini selalu mengembalikan TRUE.

Keterangan

CBasePane::P aneFromPoint

Mengembalikan panel yang berisi titik yang diberikan.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL) const;

Parameter

Titik
[di] Menentukan titik, dalam koordinat layar, untuk memeriksa.

nSensitivitas
[di] Tingkatkan area pencarian dengan jumlah ini. Panel akan memenuhi kriteria pencarian jika titik yang diberikan berada di area yang ditingkatkan.

bExactBar
[di] TRUE untuk mengabaikan parameter nSensitivitas ; jika tidak, FALSE.

pRTCBarType
[di] Jika bukan NULL, metode hanya mencari panel dari jenis yang ditentukan.

Tampilkan Nilai

Objek CBasePane-turunan yang berisi titik tertentu, atau NULL jika tidak ada panel yang ditemukan.

CBasePane::RecalcLayout

CBasePane tidak menggunakan metode ini.

virtual void RecalcLayout();

CBasePane::RemovePaneFromDockManager

Membatalkan pendaftaran panel dan menghapusnya dari daftar di manajer docking.

void RemovePaneFromDockManager(
    CBasePane* pBar,
    BOOL bDestroy = TRUE,
    BOOL bAdjustLayout = FALSE,
    BOOL bAutoHide = FALSE,
    CBasePane* pBarReplacement = NULL);

Parameter

pBar
[di] Penunjuk ke panel yang akan dihapus.

bDestroy
[di] Jika TRUE, panel yang dihapus akan dihancurkan.

bAdjustLayout
[di] Jika TRUE, segera sesuaikan tata letak docking.

bAutoHide
[di] Jika TRUE, tata letak docking terkait dengan daftar bilah autohide. Jika FALSE, tata letak docking terkait dengan daftar panel reguler.

pBarReplacement
[di] Penunjuk ke panel yang menggantikan panel yang dihapus.

CBasePane::SaveState

Menyimpan status panel ke registri.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[di] Nama profil.

nIndex
[di] Indeks profil.

uiID
[di] ID Panel.

Tampilkan Nilai

TRUE jika status berhasil disimpan; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini saat menyimpan status panel ke registri. Ambil alih SaveState di kelas turunan untuk menyimpan informasi tambahan.

CBasePane::SelectDefaultFont

Memilih font default untuk konteks perangkat tertentu.

CFont* SelectDefaultFont(CDC* pDC);

Parameter

Pdc
[di] Konteks perangkat.

Tampilkan Nilai

Penunjuk ke objek Kelas CFont default.

CBasePane::SetControlBarStyle

Mengatur gaya bilah kontrol.

virtual void SetControlBarStyle(DWORD dwNewStyle);

Parameter

dwNewStyle
[di] Kombinasi bitwise-OR dari kemungkinan nilai berikut.

Gaya	Deskripsi
AFX_CBRS_FLOAT	Membuat bilah kontrol mengapung.
AFX_CBRS_AUTOHIDE	Mengaktifkan mode sembunyikan otomatis.
AFX_CBRS_RESIZE	Mengaktifkan perubahan ukuran bilah kontrol. Saat bendera ini diatur, bilah kontrol dapat ditempatkan di panel yang dapat ditampung.
AFX_CBRS_CLOSE	Memungkinkan persembunyian bilah kontrol.

CBasePane::SetDockingMode

Mengatur mode docking untuk panel.

void SetDockingMode(AFX_DOCK_TYPE dockModeNew);

Parameter

dockModeNew
[di] Menentukan mode docking baru untuk panel.

Keterangan

Kerangka kerja ini mendukung dua mode docking: standar dan langsung.

Dalam mode docking standar, panel dan jendela bingkai mini dipindahkan menggunakan persegi panjang seret. Dalam mode docking langsung, bilah kontrol dan jendela bingkai mini segera dipindahkan dengan konteksnya.

Awalnya, mode docking didefinisikan secara global oleh CDockingManager::m_dockModeGlobal. Anda dapat mengatur mode docking untuk setiap panel satu per SetDockingMode satu menggunakan metode .

CBasePane::SetPaneAlignment

Mengatur perataan untuk panel.

virtual void SetPaneAlignment(DWORD dwAlignment);

Parameter

dwAlignment
[di] Menentukan perataan baru.

Keterangan

Biasanya, kerangka kerja memanggil metode ini ketika panel ditambatkan dari satu sisi bingkai utama ke sisi lain.

Tabel berikut ini memperlihatkan kemungkinan nilai untuk dwAlignment:

Nilai	Penjajaran
CBRS_ALIGN_LEFT	Perataan kiri.
CBRS_ALIGN_RIGHT	Perataan kanan.
CBRS_ALIGN_TOP	Perataan atas.
CBRS_ALIGN_BOTTOM	Perataan bawah.

CBasePane::SetPaneStyle

Mengatur gaya panel.

virtual void SetPaneStyle(DWORD dwNewStyle);

Parameter

dwNewStyle
[di] Menentukan gaya baru yang akan disetel.

Keterangan

Metode ini dapat digunakan untuk mengatur salah satu gaya CBRS_ yang ditentukan dalam afxres.h. Karena gaya panel dan perataan panel disimpan bersama-sama, atur gaya baru dengan menggabungkannya dengan perataan saat ini sebagai berikut.

pPane->SetPaneStyle (pPane->GetCurrentAlignment() | CBRS_TOOLTIPS);

CBasePane::SetWindowPos

Mengubah ukuran, posisi, dan urutan Z panel.

virtual HDWP SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags,
    HDWP hdwp = NULL);

Parameter

pWndInsertAfter
[di] CWnd Mengidentifikasi objek yang muncul sebelum objek ini CWnd dalam urutan Z. Untuk informasi selengkapnya, lihat CWnd::SetWindowPos.

x
[di] Menentukan posisi sisi kiri jendela.

y
[di] Menentukan posisi bagian atas jendela.

Cx
[di] Menentukan lebar jendela.

Cy
[di] Menentukan tinggi jendela.

nFlags
[di] Menentukan opsi ukuran dan posisi. Untuk informasi selengkapnya, lihat CWnd::SetWindowPos.

hdwp
[di] Tangani ke struktur yang berisi informasi ukuran dan posisi untuk satu atau beberapa jendela.

Tampilkan Nilai

Handel ke struktur posisi jendela yang ditangguhkan yang diperbarui, atau NULL.

Keterangan

Jika pWndInsertAfter adalah NULL, metode ini memanggil CWnd::SetWindowPos. Jika pWndInsertAfter non-NULL, metode ini memanggil DeferWindowPos.

CBasePane::ShowPane

Memperlihatkan atau menyembunyikan panel.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parameter

bShow
[di] Menentukan apakah akan menampilkan (TRUE) atau menyembunyikan (FALSE) panel.

bDelay
[di] Jika TRUE, menghitung ulang tata letak docking akan tertunda.

bActivate
[di] Jika TRUE, panel aktif saat ditampilkan.

Keterangan

Metode ini memperlihatkan atau menyembunyikan panel. Gunakan metode ini alih-alih ShowWindow karena metode ini memberi tahu manajer docking yang relevan tentang perubahan dalam visibilitas panel.

Gunakan CBasePane::IsVisible untuk menentukan visibilitas panel saat ini.

CBasePane::StretchPane

Membentangkan panel secara vertikal atau horizontal.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parameter

nLength
[di] Panjang untuk membentangkan panel.

bVert
[di] Jika TRUE, bentangkan panel secara vertikal. Jika FALSE, bentangkan panel secara horizontal.

Tampilkan Nilai

Ukuran panel yang direntangkan.

CBasePane::UndockPane

Menghapus panel dari situs dock, slider default, atau jendela bingkai mini tempat panel tersebut saat ini ditambatkan.

virtual void UndockPane(BOOL bDelay=FALSE);

Parameter

bDelay
Jika TRUE, tata letak docking tidak segera dihitung ulang.

Keterangan

Panggil metode ini untuk memanipulasi status panel atau mengecualikan panel dari tata letak docking.

Jika Anda ingin terus menggunakan panel ini, panggil CBasePane::D ockPane atau CBasePane::FloatPane sebelum memanggil metode ini.

Baca juga

Bagan Hierarki
Kelas
CPane
Kelas CWnd