Bagikan melalui

Kelas CBaseTabbedPane

  • Artikel

Memperluas fungsionalitas Kelas CDockablePane untuk mendukung pembuatan jendela bertab.

Sintaks

class CBaseTabbedPane : public CDockablePane

Anggota

Konstruktor Publik

Nama Deskripsi
CBaseTabbedPane::CBaseTabbedPane Konstruktor default.

Metode Publik

Nama Deskripsi
CBaseTabbedPane::AddTab Menambahkan tab baru ke panel bertab.
CBaseTabbedPane::AllowDestroyEmptyTabbedPane Menentukan apakah panel bertab kosong dapat dihancurkan.
CBaseTabbedPane::ApplyRestoredTabInfo Menerapkan pengaturan tab, yang dimuat dari registri, ke panel bertab.
CBaseTabbedPane::CanFloat Menentukan apakah panel dapat mengambang. (Penimpaan CBasePane::CanFloat.)
CBaseTabbedPane::CanSetCaptionTextToTabName Menentukan apakah keterangan untuk panel bertab harus menampilkan teks yang sama dengan tab aktif.
CBaseTabbedPane::ConvertToTabbedDocument (Penimpaan CDockablePane::ConvertToTabbedDocument.)
CBaseTabbedPane::D etachPane Mengonversi satu atau beberapa panel yang dapat ditautkan ke dokumen bertab MDI.
CBaseTabbedPane::EnableSetCaptionTextToTabName Mengaktifkan atau menonaktifkan kemampuan panel bertab untuk menyinkronkan teks keterangan dengan teks label pada tab aktif.
CBaseTabbedPane::FillDefaultTabsOrderArray Memulihkan urutan tab internal ke status default.
CBaseTabbedPane::FindBarByTabNumber Mengembalikan panel yang berada di tab saat tab diidentifikasi oleh indeks tab berbasis nol.
CBaseTabbedPane::FindPaneByID Mengembalikan panel yang diidentifikasi oleh ID panel.
CBaseTabbedPane::FloatTab Mengambangkan panel, tetapi hanya jika panel saat ini berada di tab yang dapat dilepas.
CBaseTabbedPane::GetDefaultTabsOrder Mengembalikan urutan default tab di panel.
CBaseTabbedPane::GetFirstVisibleTab Mengambil penunjuk ke tab pertama yang ditampilkan.
CBaseTabbedPane::GetMinSize Mengambil ukuran minimum yang diizinkan untuk panel. (Penimpaan CPane::GetMinSize.)
CBaseTabbedPane::GetPaneIcon Mengembalikan handel ke ikon panel. (Penimpaan CBasePane::GetPaneIcon.)
CBaseTabbedPane::GetPaneList Mengembalikan daftar panel yang terkandung dalam panel bertab.
CBaseTabbedPane::GetTabArea Mengembalikan persegi panjang pembatas untuk area tab atas dan bawah.
CBaseTabbedPane::GetTabsNum Mengembalikan jumlah tab dalam jendela tab.
CBaseTabbedPane::GetUnderlyingWindow Mendapatkan jendela tab yang mendasar (dibungkus).
CBaseTabbedPane::GetVisibleTabsNum Mengembalikan jumlah tab yang ditampilkan.
CBaseTabbedPane::HasAutoHideMode Menentukan apakah panel bertab dapat dialihkan ke mode sembunyikan otomatis.
CBaseTabbedPane::IsHideSingleTab Menentukan apakah panel bertab disembunyikan jika hanya satu tab yang ditampilkan.
CBaseTabbedPane::LoadSiblingPaneIDs Digunakan secara internal selama serialisasi.
CBaseTabbedPane::RecalcLayout Menghitung ulang informasi tata letak untuk panel. (Penimpaan CPane::RecalcLayout.)
CBaseTabbedPane::RemovePane Menghapus panel dari panel bertab.
CBaseTabbedPane::SaveSiblingBarIDs Digunakan secara internal selama serialisasi.
CBaseTabbedPane::Serialize (Penimpaan CDockablePane::Serialize.)
CBaseTabbedPane::SerializeTabWindow Digunakan secara internal selama serialisasi.
CBaseTabbedPane::SetAutoDestroy Menentukan apakah bilah kontrol bertab akan dihancurkan secara otomatis.
CBaseTabbedPane::SetAutoHideMode Beralih ke panel docking antara mode ditampilkan dan sembunyikan otomatis. (Penimpaan CDockablePane::SetAutoHideMode.)
CBaseTabbedPane::ShowTab Memperlihatkan atau menyembunyikan tab.

Keterangan

Kelas ini adalah kelas abstrak dan tidak dapat diinstansiasi. Ini mengimplementasikan layanan yang umum untuk semua jenis panel bertab.

Saat ini, pustaka menyertakan dua kelas panel bertab turunan: Kelas CTabbedPane dan Kelas CMFCOutlookBar.

Objek CBaseTabbedPane membungkus penunjuk ke objek Kelas CMFCBaseTabCtrl. Kelas CMFCBaseTabCtrl kemudian menjadi jendela anak dari panel bertab.

Untuk informasi selengkapnya tentang cara membuat panel bertab, lihat Kelas CDockablePane, Kelas CTabbedPane, dan Kelas CMFCOutlookBar.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CBaseTabbedPane

Persyaratan

Header: afxBaseTabbedPane.h

CBaseTabbedPane::AddTab

Menambahkan tab baru ke panel bertab.

virtual BOOL AddTab(
    CWnd* pNewBar,
    BOOL bVisible = TRUE,
    BOOL bSetActive = TRUE,
    BOOL bDetachable = TRUE);

Parameter

pNewBar
[masuk, keluar] Penunjuk ke panel untuk ditambahkan. Penunjuk ini mungkin menjadi tidak valid setelah Anda memanggil metode ini. Untuk informasi lebih lanjut, lihat bagian Keterangan.

bVisible
[di] TRUE untuk membuat tab terlihat; jika tidak, FALSE.

bSetActive
[di] TRUE untuk membuat tab menjadi tab aktif; jika tidak, FALSE.

bDetachable
[di] TRUE untuk membuat tab dapat dilepas; jika tidak, FALSE.

Tampilkan Nilai

TRUE jika panel berhasil ditambahkan sebagai tab dan tidak dihancurkan dalam proses. FALSE jika panel yang ditambahkan adalah objek jenis CBaseTabbedPane. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Keterangan

Panggil metode ini untuk menambahkan panel sebagai tab baru pada panel bertab. Jika pNewBar menunjuk ke objek jenis CBaseTabbedPane, semua tabnya disalin ke panel bertab lalu pNewBar dihancurkan. Dengan demikian, pNewBar menjadi pointer yang tidak valid dan tidak boleh digunakan.

CBaseTabbedPane::AllowDestroyEmptyTabbedPane

Menentukan apakah panel bertab kosong dapat dihancurkan.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Tampilkan Nilai

TRUE jika panel bertab kosong dapat dihancurkan; jika tidak, FALSE. Implementasi default selalu mengembalikan TRUE.

Keterangan

Jika panel bertab kosong tidak diizinkan untuk dihancurkan, kerangka kerja menyembunyikan panel sebagai gantinya.

CBaseTabbedPane::ApplyRestoredTabInfo

Memuat pengaturan tab dari registri dan menerapkannya ke panel bertab.

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Parameter

bUseTabIndexes
[di] Parameter ini digunakan secara internal oleh kerangka kerja.

Keterangan

Metode ini dipanggil oleh kerangka kerja ketika memuat ulang informasi status docking dari registri. Metode ini mendapatkan informasi tentang urutan tab dan nama tab untuk panel bertab.

CBaseTabbedPane::CanFloat

Menentukan apakah panel bertab dapat mengambang.

virtual BOOL CanFloat() const;

Tampilkan Nilai

TRUE jika panel dapat mengambang; jika tidak, FALSE.

CBaseTabbedPane::CanSetCaptionTextToTabName

Menentukan apakah keterangan untuk panel bertab harus menampilkan teks yang sama dengan tab aktif.

virtual BOOL CanSetCaptionTextToTabName() const;

Tampilkan Nilai

TRUE jika teks keterangan panel bertab diatur ke teks tab aktif; jika tidak, FALSE.

Keterangan

Metode ini digunakan untuk menentukan apakah teks yang ditampilkan pada keterangan panel bertab menduplikasi label tab aktif. Anda dapat mengaktifkan atau menonaktifkan fungsionalitas ini dengan memanggil CBaseTabbedPane::EnableSetCaptionTextToTabName.

CBaseTabbedPane::ConvertToTabbedDocument

Mengonversi satu atau beberapa panel yang dapat ditautkan ke dokumen bertab MDI.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

Parameter

bActiveTabOnly
[di] Saat Anda mengonversi panel bertab, tentukan TRUE untuk mengonversi hanya tab aktif. Tentukan FALSE untuk mengonversi semua tab di panel.

CBaseTabbedPane::D etachPane

Mencopot panel dari panel bertab.

virtual BOOL DetachPane(
    CWnd* pBar,
    BOOL bHide = FALSE);

Parameter

pBar
[di] Arahkan ke panel untuk melepaskan.

bHide
[di] Parameter Boolean yang menentukan apakah kerangka kerja menyembunyikan panel setelah dilepaskan.

Tampilkan Nilai

TRUE jika kerangka kerja berhasil mencopot panel; FALSE jika pBar NULL atau merujuk ke panel yang tidak ada di panel bertab.

Keterangan

Kerangka kerja mengambang di panel yang dilepas jika memungkinkan. Untuk informasi selengkapnya, lihat CBasePane::CanFloat.

CBaseTabbedPane::EnableSetCaptionTextToTabName

Mengaktifkan atau menonaktifkan kemampuan panel bertab untuk menyinkronkan teks keterangan dengan teks label pada tab aktif.

virtual void EnableSetCaptionTextToTabName(BOOL bEnable);

Parameter

bEnable
[di] TRUE untuk menyinkronkan keterangan panel bertab dengan keterangan tab aktif; jika tidak, FALSE.

CBaseTabbedPane::FillDefaultTabsOrderArray

Memulihkan urutan tab internal ke status default.

void FillDefaultTabsOrderArray();

Keterangan

Metode ini dipanggil ketika kerangka kerja memulihkan bilah Outlook ke status awal.

CBaseTabbedPane::FindPaneByID

Mengembalikan panel yang diidentifikasi oleh ID panel.

virtual CWnd* FindPaneByID(UINT uBarID);

Parameter

uBarID
[di] Menentukan ID panel yang akan ditemukan.

Tampilkan Nilai

Penunjuk ke panel jika ditemukan; jika tidak, NULL.

Keterangan

Metode ini membandingkan semua tab di panel dan mengembalikan tab dengan ID yang ditentukan oleh parameter uBarID .

CBaseTabbedPane::FindBarByTabNumber

Mengembalikan panel yang berada di tab.

virtual CWnd* FindBarByTabNumber(
    int nTabNum,
    BOOL bGetWrappedBar = FALSE);

Parameter

nTabNum
[di] Menentukan indeks berbasis nol dari tab yang akan diambil.

bGetWrappedBar
[di] TRUE untuk mengembalikan jendela panel yang mendasar (dibungkus) alih-alih panel itu sendiri; jika tidak FALSE. Ini hanya berlaku untuk panel yang berasal dari CDockablePaneAdapter.

Tampilkan Nilai

Jika panel ditemukan, maka penunjuk yang valid ke panel yang sedang dicari dikembalikan; jika tidak, NULL.

Keterangan

Panggil metode ini untuk mengambil panel yang berada di tab yang ditentukan oleh parameter nTabNum .

CBaseTabbedPane::FloatTab

Mengambangkan panel, tetapi hanya jika panel saat ini berada di tab yang dapat dilepas.

virtual BOOL FloatTab(
    CWnd* pBar,
    int nTabID,
    AFX_DOCK_METHOD dockMethod,
    BOOL bHide = FALSE);

Parameter

pBar
[masuk, keluar] Penunjuk ke panel untuk mengambang.

nTabID
[di] Menentukan indeks berbasis nol tab untuk mengambang.

dockMethod
[di] Menentukan metode yang akan digunakan untuk membuat panel mengambang. Untuk informasi lebih lanjut, lihat bagian Keterangan.

bHide
[di] TRUE untuk menyembunyikan panel sebelum mengambang; jika tidak, FALSE.

Tampilkan Nilai

TRUE jika panel mengambang; jika tidak, FALSE.

Keterangan

Panggil metode ini untuk mengambangkan panel yang saat ini berada di tab yang dapat dilepas.

Jika Anda ingin melepaskan panel secara terprogram, tentukan DM_SHOW untuk parameter dockMethod . Jika Anda ingin mengambangkan panel dalam posisi yang sama di mana panel mengambang sebelumnya, tentukan DM_DBL_CLICK sebagai parameter dockMethod .

CBaseTabbedPane::GetDefaultTabsOrder

Mengembalikan urutan default tab di panel.

const CArray<int,int>& GetDefaultTabsOrder();

Tampilkan Nilai

Objek CArray yang menentukan urutan tab default di panel.

Keterangan

Kerangka kerja memanggil metode ini ketika bilah Outlook direset ke status awal.

CBaseTabbedPane::GetFirstVisibleTab

Mengambil penunjuk ke tab pertama yang ditampilkan.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

Parameter

iTabNum
[di] Referensi ke bilangan bulat. Metode ini menulis indeks berbasis nol dari tab pertama yang ditampilkan ke parameter ini, atau -1 jika tidak ada tab yang ditampilkan yang ditemukan.

Tampilkan Nilai

Jika berhasil, penunjuk ke tab pertama yang ditampilkan; jika tidak, NULL.

CBaseTabbedPane::GetMinSize

Mengambil ukuran minimum yang diizinkan untuk panel.

virtual void GetMinSize(CSize& size) const;

Parameter

ukuran
[out] Objek CSize yang diisi dengan ukuran minimum yang diizinkan.

Keterangan

Jika penanganan ukuran panel minimum yang konsisten aktif ( CPane::m_bHandleMinSize), ukuran diisi dengan ukuran minimum yang diizinkan untuk tab aktif. Jika tidak, ukuran diisi dengan nilai pengembalian CPane::GetMinSize.

CBaseTabbedPane::GetPaneIcon

Mengambil ukuran minimum yang diizinkan untuk panel.

virtual void GetMinSize(CSize& size) const;

Parameter

ukuran
[out] Objek CSize yang diisi dengan ukuran minimum yang diizinkan.

Keterangan

Jika penanganan ukuran panel minimum yang konsisten aktif ( CPane::m_bHandleMinSize), ukuran diisi dengan ukuran minimum yang diizinkan untuk tab aktif. Jika tidak, ukuran diisi dengan nilai pengembalian CPane::GetMinSize.

CBaseTabbedPane::GetPaneList

Mengembalikan daftar panel yang terkandung dalam panel bertab.

virtual void GetPaneList(
    CObList& lst,
    CRuntimeClass* pRTCFilter = NULL);

Parameter

Lst
[out] CObList Yang diisi dengan panel yang terkandung di panel bertab.

pRTCFilter
[di] Jika bukan NULL, daftar yang dikembalikan hanya berisi panel yang merupakan kelas runtime yang ditentukan.

CBaseTabbedPane::GetTabArea

Mengembalikan persegi panjang pembatas untuk area tab atas dan bawah.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const = 0;

Parameter

rectTabAreaTop
[out] Menerima koordinat layar area tab atas.

rectTabAreaBottom
[out] Menerima koordinat layar area tab bawah.

Keterangan

Panggil metode ini untuk menentukan persegi panjang pembatas, dalam koordinat layar, untuk area tab atas dan bawah.

CBaseTabbedPane::GetTabsNum

Mengembalikan jumlah tab dalam jendela tab.

virtual int GetTabsNum() const;

Tampilkan Nilai

Jumlah tab di panel bertab.

CBaseTabbedPane::GetUnderlyingWindow

Mendapatkan jendela tab yang mendasar (dibungkus).

virtual CMFCBaseTabCtrl* GetUnderlyingWindow();

Tampilkan Nilai

Penunjuk ke jendela tab yang mendasar.

CBaseTabbedPane::GetVisibleTabsNum

Mengembalikan jumlah tab yang terlihat.

virtual int GetVisibleTabsNum() const;

Tampilkan Nilai

Jumlah tab yang terlihat, yang akan lebih besar dari atau sama dengan nol.

Keterangan

Panggil metode ini untuk menentukan jumlah tab yang terlihat di panel bertab.

CBaseTabbedPane::HasAutoHideMode

Menentukan apakah panel bertab dapat dialihkan ke mode autohide.

virtual BOOL HasAutoHideMode() const;

Tampilkan Nilai

TRUE jika panel dapat dialihkan ke mode autohide; jika tidak, FALSE.

Keterangan

Jika mode autohide dinonaktifkan, tidak ada tombol sematkan yang ditampilkan pada keterangan panel bertab.

CBaseTabbedPane::IsHideSingleTab

Menentukan apakah panel bertab disembunyikan jika hanya satu tab yang ditampilkan.

virtual BOOL IsHideSingleTab() const;

Tampilkan Nilai

TRUE jika jendela tab tidak ditampilkan saat hanya ada satu tab yang terlihat; jika tidak, FALSE.

Keterangan

Jika panel tidak ditampilkan karena hanya satu tab yang terbuka, Anda dapat memanggil metode ini untuk menentukan apakah panel bertab berfungsi dengan benar.

CBaseTabbedPane::RemovePane

Menghapus panel dari panel bertab.

virtual BOOL RemovePane(CWnd* pBar);

Parameter

pBar
[masuk, keluar] Penunjuk ke panel untuk dihapus dari panel bertab.

Tampilkan Nilai

TRUE jika panel berhasil dihapus dari panel bertab dan jika panel bertab masih valid. FALSE jika panel terakhir telah dihapus dari panel bertab dan panel bertab akan dihancurkan. Jika nilai yang dikembalikan adalah FALSE, jangan gunakan panel bertab lagi.

Keterangan

Panggil metode ini untuk menghapus panel yang ditentukan oleh parameter pBar dari panel bertab.

CBaseTabbedPane::SetAutoDestroy

Menentukan apakah bilah kontrol bertab akan dihancurkan secara otomatis.

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Parameter

bAutoDestroy
[di] TRUE jika panel bertab dibuat secara dinamis dan Anda tidak mengontrol masa pakainya; jika tidak, FALSE.

Keterangan

Atur mode hancurkan otomatis ke TRUE jika Anda membuat panel bertab secara dinamis dan jika Anda tidak mengontrol masa pakainya. Jika mode perusakan otomatis TRUE, panel bertab akan dihancurkan secara otomatis oleh kerangka kerja.

CBaseTabbedPane::ShowTab

Memperlihatkan atau menyembunyikan tab.

virtual BOOL ShowTab(
    CWnd* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parameter

pBar
[di] Penunjuk ke panel untuk ditampilkan atau disembunyikan.

bShow
[di] TRUE untuk memperlihatkan panel; FALSE untuk menyembunyikan panel.

bDelay
[di] TRUE untuk menunda penyesuaian tata letak tab; jika tidak, FALSE.

bActivate
[di] TRUE untuk membuat tab menjadi tab aktif; jika tidak, FALSE.

Tampilkan Nilai

TRUE jika tab berhasil ditampilkan atau disembunyikan; jika tidak, FALSE.

Keterangan

Saat Anda memanggil metode ini, panel ditampilkan atau disembunyikan, tergantung pada nilai parameter bShow . Jika Anda menyembunyikan tab dan tab tersebut adalah tab terakhir yang terlihat di jendela tab yang mendasar, panel bertab disembunyikan. Jika Anda memperlihatkan tab saat sebelumnya tidak ada tab yang terlihat, panel bertab ditampilkan.

CBaseTabbedPane::RecalcLayout

Menghitung ulang informasi tata letak untuk panel.

virtual void RecalcLayout();

Keterangan

Jika panel mengambang, metode ini memberi tahu kerangka kerja untuk mengubah ukuran panel ke ukuran bingkai mini saat ini.

Jika panel ditampung, metode ini tidak melakukan apa pun.

CBaseTabbedPane::SetAutoHideMode

Mengatur mode sembunyikan otomatis untuk panel yang dapat dilepas di panel bertab.

virtual CMFCAutoHideToolBar* SetAutoHideMode(
    BOOL bMode,
    DWORD dwAlignment,
    CMFCAutoHideToolBar* pCurrAutoHideBar = NULL,
    BOOL bUseTimer = TRUE);

Parameter

bMode
[di] TRUE untuk mengaktifkan mode sembunyikan otomatis; FALSE untuk mengaktifkan mode docking reguler.

dwAlignment
[di] Menentukan perataan panel sembunyikan otomatis yang akan dibuat. Untuk daftar nilai yang mungkin, lihat CPane::MoveByAlignment.

pCurrAutoHideBar
[masuk, keluar] Penunjuk ke bilah alat sembunyikan otomatis saat ini. Bisa NULL.

bUseTimer
[di] Menentukan apakah akan menggunakan efek sembunyikan otomatis saat pengguna mengalihkan panel ke mode sembunyikan otomatis, atau untuk segera menyembunyikan panel.

Tampilkan Nilai

Penunjuk ke toolbar sembunyikan otomatis yang dibuat saat beralih ke mode sembunyikan otomatis, atau NULL jika tidak ada toolbar yang dibuat.

Keterangan

Kerangka kerja memanggil metode ini ketika pengguna memilih tombol sematkan untuk mengalihkan panel bertab ke mode sembunyikan otomatis atau ke mode docking biasa.

Mode sembunyikan otomatis diatur untuk setiap panel yang dapat dilepas di panel bertab. Panel yang tidak dapat dilepas diabaikan. Untuk informasi selengkapnya, lihat CMFCBaseTabCtrl::EnableTabDetach.

Panggil metode ini untuk mengalihkan panel bertab ke mode sembunyikan otomatis secara terprogram. Panel harus ditambatkan ke jendela bingkai utama ( CDockablePane::GetDefaultPaneDivider harus mengembalikan pointer yang valid ke CPaneDivider).

Lihat juga

Bagan Hierarki
Kelas
Kelas CDockablePane