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
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 | Puncak. |
CBRS_ALIGN_BOTTOM | Dasar. |
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
ujung
[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.
ujung
[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
ujung
[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.