Kelas CMFCBaseTabCtrl

Artikel
10/12/2023

Menerapkan fungsionalitas dasar untuk jendela bertab. Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

Sintaks

class CMFCBaseTabCtrl : public CWnd

Anggota

Metode Publik

Nama	Deskripsi
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab	Menambahkan tab baru ke jendela bertab.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::D etachTab	Mencopot tab dari jendela bertab.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor	Mengaktifkan atau menonaktifkan pewarnaan tab otomatis.
CMFCBaseTabCtrl::EnableCustomToolTips	Mengaktifkan atau menonaktifkan tipsalat kustom untuk tab.
CMFCBaseTabCtrl::EnableInPlaceEdit	Mengaktifkan atau menonaktifkan pengeditan langsung label tab.
CMFCBaseTabCtrl::EnableTabDetach	Mengaktifkan tab yang dapat dilepas.
CMFCBaseTabCtrl::EnableTabSwap	Mengaktifkan atau menonaktifkan apakah pengguna dapat mengubah urutan tab dengan menggunakan mouse.
CMFCBaseTabCtrl::EnsureVisible	Menggulir tab hingga tab yang ditentukan terlihat. Metode ini tidak berpengaruh jika tab yang ditentukan sudah terlihat.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd	Mengembalikan panel yang berisi titik tertentu.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab	Mengembalikan indeks tab aktif.
CMFCBaseTabCtrl::GetActiveTabColor	Mengembalikan warna latar belakang tab aktif.
CMFCBaseTabCtrl::GetActiveTabTextColor	Mengembalikan warna teks tab aktif.
CMFCBaseTabCtrl::GetActiveWnd	Mengembalikan penunjuk halaman aktif kontrol tab.
CMFCBaseTabCtrl::GetAutoColors	Mengembalikan referensi ke array warna yang digunakan untuk pewarnaan otomatis.
CMFCBaseTabCtrl::GetFirstVisibleTab	Mengembalikan penunjuk ke tab pertama yang terlihat.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab	Mengembalikan indeks tab yang saat ini disorot.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation	Mengembalikan variabel jenis data LOCATION yang menunjukkan tempat area tab diposisikan relatif terhadap kontrol tab. Misalnya, di bagian atas atau di bagian bawah.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea	Mengembalikan ukuran dan posisi area tab di jendela bertab. Posisi area tab ditentukan dengan menggunakan koordinat.
CMFCBaseTabCtrl::GetTabBkColor	Mengembalikan warna latar belakang tab yang ditentukan.
CMFCBaseTabCtrl::GetTabBorderSize	Mengembalikan ukuran batas tab dalam kontrol tab.
CMFCBaseTabCtrl::GetTabByID	Mengembalikan indeks tab yang diidentifikasi oleh ID tertentu.
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd	Mengembalikan indeks tab yang berisi objek HWND tertentu.
CMFCBaseTabCtrl::GetTabFromPoint	Mengembalikan tab yang berisi titik tertentu.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon	Mengembalikan ikon yang terkait dengan tab yang ditentukan.
CMFCBaseTabCtrl::GetTabID	Mengembalikan ID tab dengan menggunakan indeks tab.
CMFCBaseTabCtrl::GetTabIcon	Mengembalikan ID ikon untuk tab tertentu.
CMFCBaseTabCtrl::GetTabLabel	Mengembalikan teks tab tertentu.
CMFCBaseTabCtrl::GetTabRect	Mengambil ukuran dan posisi tab tertentu.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor	Mengembalikan warna teks dari tab tertentu.
CMFCBaseTabCtrl::GetTabWnd	Mengembalikan penunjuk ke panel yang berada di halaman tab tertentu.
CMFCBaseTabCtrl::GetTabWndNoWrapper	Mengembalikan penunjuk langsung ke kontrol yang berada di halaman tab tertentu, meskipun kontrol memiliki pembungkus.
CMFCBaseTabCtrl::GetTabsNum	Mengembalikan jumlah tab yang terkandung dalam kontrol tab.
CMFCBaseTabCtrl::GetToolTipCtrl	Mengembalikan referensi ke kontrol tipsalat yang `CMFCBaseTabCtrl` terkait dengan objek.
CMFCBaseTabCtrl::GetVisibleTabsNum	Mengembalikan jumlah tab yang terlihat.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab	Mengatur opsi yang menyembunyikan tab jendela, tetapi hanya jika jendela bertab hanya menampilkan satu tab yang terlihat.
CMFCBaseTabCtrl::InsertTab	Sisipkan tab baru.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor	Mengembalikan nilai yang menunjukkan apakah jendela bertab berada dalam mode warna otomatis.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame	Mengembalikan nilai yang menunjukkan apakah bingkai untuk area tab datar atau 3D.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab	Mengembalikan nilai yang menunjukkan apakah kontrol tab dikonfigurasi untuk menyembunyikan tab, tetapi hanya jika jendela bertab hanya memiliki satu tab yang terlihat.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit	Menunjukkan apakah pengguna dapat mengubah label pada tab.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle	Menunjukkan apakah jendela bertab menampilkan tab dalam gaya Microsoft OneNote.
CMFCBaseTabCtrl::IsPtInTabArea	Memeriksa apakah titik tertentu ada di area tab.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable	Menunjukkan apakah tab dapat dilepas.
CMFCBaseTabCtrl::IsTabIconOnly	Menunjukkan apakah tab menampilkan ikon tetapi bukan label.
CMFCBaseTabCtrl::IsTabSwapEnabled	Menunjukkan apakah pengguna dapat mengubah posisi tab dengan menyeret tab.
CMFCBaseTabCtrl::IsTabVisible	Menunjukkan apakah tab tertentu terlihat.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs	Dipanggil oleh kerangka kerja saat jumlah tab berubah.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::P reTranslateMessage	Digunakan oleh CWinApp kelas untuk menerjemahkan pesan jendela sebelum dikirim ke fungsi Windows TranslateMessage dan DispatchMessage. (Penimpaan CWnd::P reTranslateMessage.)
CMFCBaseTabCtrl::RecalcLayout	Menghitung ulang tata letak internal jendela bertab.
CMFCBaseTabCtrl::RemoveAllTabs	Menghapus semua tab dari jendela bertab.
CMFCBaseTabCtrl::RemoveTab	Menghapus tab dari jendela bertab.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList	Mereset daftar gambar yang dilampirkan ke jendela bertab.
CMFCBaseTabCtrl::Serialize	Membaca atau menulis objek ini dari atau ke arsip. (Penimpaan CObject::Serialize.)
CMFCBaseTabCtrl::SetActiveTab	Mengaktifkan tab.
CMFCBaseTabCtrl::SetActiveTabColor	Mengatur warna latar belakang untuk tab yang saat ini aktif.
CMFCBaseTabCtrl::SetActiveTabTextColor	Mengatur warna teks untuk tab aktif.
CMFCBaseTabCtrl::SetAutoColors	Mengatur warna kontrol tab yang diterapkan dalam mode warna otomatis.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC	Mengatur kelas pembungkus yang digunakan untuk objek apa pun yang tidak berasal dari Kelas CDockablePane.
CMFCBaseTabCtrl::SetDrawNoPrefix	Mengaktifkan dan menonaktifkan pemrosesan karakter awalan saat label tab digambar.
CMFCBaseTabCtrl::SetImageList	Mengatur daftar gambar ikon.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor	Mengatur warna latar belakang untuk tab tertentu.
CMFCBaseTabCtrl::SetTabBorderSize	Mengatur ukuran batas tab baru.
CMFCBaseTabCtrl::SetTabHicon	Mengatur ikon tab.
CMFCBaseTabCtrl::SetTabIcon	Mengatur ID ikon tab.
CMFCBaseTabCtrl::SetTabIconOnly	Mengaktifkan dan menonaktifkan mode "hanya ikon" untuk tab tertentu.
CMFCBaseTabCtrl::SetTabLabel	Mengatur label tab sama dengan nilai string tertentu.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor	Mengatur warna teks untuk tab tertentu.
CMFCBaseTabCtrl::SetTabsOrder	Mengatur tab dalam urutan yang ditentukan.
CMFCBaseTabCtrl::ShowTab	Memperlihatkan atau menyembunyikan tab yang ditentukan.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Metode yang Dilindungi

Nama	Deskripsi
CMFCBaseTabCtrl::CreateWrapper	Membuat pembungkus untuk objek yang berasal dari CWnd yang tidak berasal dari `CDockablePane`. Untuk menambatkan `CMFCBaseTabCtrl` objek, setiap kontrol yang disematkan harus memiliki pembungkus docking atau berasal dari `CDockablePane`. Anda mengatur kelas pembungkus dengan menggunakan `SetDockingBayWrapperRTC`.

Anggota Data

Nama	Deskripsi
CMFCBaseTabCtrl::m_bActivateTabOnRightClick	Menentukan apakah tab dipilih dengan menggunakan klik mouse kiri atau klik kanan mouse.
CMFCBaseTabCtrl::m_bAutoDestroyWindow	Menentukan apakah panel yang terkandung dalam tab dihancurkan secara otomatis.

Keterangan

Kelas CMFCBaseTabCtrl ini adalah kelas abstrak. Oleh karena itu, itu tidak dapat diinstansiasi. Untuk membuat jendela bertab, Anda harus mendapatkan kelas dari CMFCBaseTabCtrl. Pustaka MFC berisi beberapa contoh kelas turunan, dua di antaranya adalah Kelas CMFCTabCtrl dan Kelas CMFCOutlookBarTabCtrl.

Dimulai dengan Visual Studio 2015, kelas ini mendukung Aksesibilitas Aktif Microsoft.

Tips Kustomisasi

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

Jika Anda mengaktifkan tab yang dapat dilepas, jangan simpan penunjuk ke jendela bertab. Tab yang dapat dilepas ini dapat dibuat dan dihancurkan secara dinamis. Oleh karena itu, pointer bisa menjadi tidak valid.
Anda dapat mengonfigurasi kontrol tab sehingga pengguna dapat memindahkan tab secara dinamis pada kontrol tab dengan menggunakan mouse. Fungsionalitas ini dibangun ke CMFCBaseTabCtrl dalam kelas . Untuk mengaktifkannya, panggil CMFCBaseTabCtrl::EnableTabSwap.
Secara default, tab dapat dilepas saat Anda menambahkannya ke kontrol tab. Anda juga dapat menambahkan tab yang tidak dapat dilepas dengan menggunakan CMFCBaseTabCtrl::AddTab. Jika Anda mengatur parameter bDetachable ke FALSE, tab tidak akan dapat dilepaskan. Anda juga dapat mengubah apakah tab dapat dilepas dengan memanggil metode CMFCBaseTabCtrl::EnableTabDetach.
Objek yang berasal dari Kelas CWnd dapat diletakkan pada bilah kontrol yang dapat di-dock atau tab yang dapat di-dok. Agar seluruh kontrol ditampung, Anda harus membuat CWnd objek dapat di-dock. Untuk mencapai hal ini, MFC menggunakan kelas pembungkus. Kelas pembungkus ini adalah Kelas CDockablePaneAdapter. Objek apa pun CWnd yang ditambahkan ke bilah kontrol yang dapat ditambat atau tab yang dapat ditambat akan dibungkus di dalam CDockablePaneAdapter objek. Anda dapat menonaktifkan pembungkusan otomatis dengan mengatur parameter m_bEnableWrapping objek Anda CMFCBaseTablCtrl ke FALSE. Anda juga dapat mengubah kelas yang akan digunakan aplikasi Anda sebagai pembungkus dengan menggunakan metode CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Hierarki Warisan

Persyaratan

Header: afxbasetabctrl.h

CMFCBaseTabCtrl::AddIcon

Menambahkan ikon ke daftar ikon di anggota yang dilindungi CMap m_mapAddedIcons .

void AddIcon(
    HICON hIcon,
    int iIcon);

Parameter

hIcon
[di] Handel ke ikon yang akan ditambahkan.

iIcon
[di] Indeks berbasis nol ikon di anggota yang dilindungi CImageList m_Images .

Keterangan

CMFCBaseTabCtrl::AddTab

Menambahkan tab baru ke kontrol tab.

virtual void AddTab(
    CWnd* pTabWnd,
    LPCTSTR lpszTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void AddTab(
    CWnd* pTabWnd,
    UINT uiResTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parameter

pTabWnd
[di] Penunjuk ke jendela yang diwakili metode ini sebagai tab baru.

lpszTabLabel
[di] String yang berisi label untuk tab baru.

uiImageId
[di] ID gambar dari daftar gambar. Kontrol tab menggunakan gambar ini sebagai ikon untuk tab baru.

uiResTabLabel
[di] ID sumber daya untuk label.

bDetachable
[di] Parameter Boolean yang menentukan apakah tab baru dapat dilepas.

Keterangan

Jika pTabWnd menunjuk ke objek yang tidak berasal dari Kelas CDockablePane dan jika bDetachable TRUE, kerangka kerja secara otomatis membuat pembungkus untuk objek pTabWnd . Pembungkus membuat objek pTabWnd dapat dilepas. Secara default, pembungkus adalah instans Kelas CDockablePaneAdapter. Jika fungsionalitas yang ditawarkan oleh pembungkus default tidak dapat diterima, gunakan metode CMFCBaseTabCtrl::SetDockingBarWrapperRTC untuk menentukan pembungkus yang berbeda.

CMFCBaseTabCtrl::ApplyRestoredTabInfo

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Parameter

[di] bUseTabIndexes

Keterangan

CMFCBaseTabCtrl::AutoDestroyWindow

void AutoDestroyWindow(BOOL bAutoDestroy = TRUE);

Parameter

[di] bAutoDestroy

Keterangan

CMFCBaseTabCtrl::CalcRectEdit

virtual void CalcRectEdit(CRect& rectEdit);

Parameter

[di] rectEdit

Keterangan

CMFCBaseTabCtrl::CleanUp

virtual void CleanUp();

Keterangan

CMFCBaseTabCtrl::ClearImageList

virtual void ClearImageList();

Keterangan

CMFCBaseTabCtrl::CreateWrapper

Membuat pembungkus untuk jendela bingkai yang berasal dari Kelas CWnd tetapi tidak berasal dari Kelas CDockablePane.

virtual CWnd* CreateWrapper(
    CWnd* pWndToWrap,
    LPCTSTR lpszTabLabel,
    BOOL bDetachable);

Parameter

pWndToWrap
[di] Penunjuk ke jendela bingkai yang dibungkus.

lpszTabLabel
[di] String yang berisi label untuk jendela.

bDetachable
[di] Parameter Boolean yang menunjukkan apakah jendela dapat dilepas.

Tampilkan Nilai

Penunjuk ke pembungkus yang berasal dari CDockablePane kelas jika CreateWrapper berhasil membuat kelas pembungkus untuk pWndToWrap. Jika metode gagal, metode mengembalikan pWndToWrap.

Keterangan

Jendela bertab dapat menambungkan objek apa pun yang berasal dari CWnd. Namun, agar CMFCBaseTabCtrl Class objek dapat dilabuhkan, setiap objek pada CMFCBaseTabCtrl harus dapat dilepas. Oleh karena itu, CMFCBaseTabCtrl secara otomatis membungkus objek apa pun yang tidak berasal dari CDockablePane.

Secara default, CMFCBaseTabCtrl membuat instans Kelas CDockablePaneAdapter. Untuk mengubah kelas default pembungkus, panggil CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Jika pWndToWrap berasal dari CDockablePane, metode ini tidak akan membuat pembungkus. Sebaliknya, itu akan gagal dan mengembalikan pWndToWrap.

CMFCBaseTabCtrl::D etachTab

Kerangka kerja memanggil metode ini untuk melepaskan tab dari kontrol tab.

virtual BOOL DetachTab(
    AFX_DOCK_METHOD dockMethod,
    int nTabNum = -1,
    BOOL bHide = FALSE);

Parameter

dockMethod
[di] Jenis data enumerasi yang disediakan oleh Kelas CBasePane. Jenis data ini menentukan metode yang digunakan untuk mencopot tab.

nTabNum
[di] Indeks berbasis nol dari tab yang akan dilepaskan.

bHide
[di] Parameter Boolean yang menunjukkan apakah kerangka kerja harus menyembunyikan tab yang dilepaskan.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Jika tab yang ditentukan oleh nTabNum tidak dapat dilepas, fungsi ini gagal dan mengembalikan FALSE.

CMFCBaseTabCtrl::EnableActivateLastActive

void EnableActivateLastActive(BOOL bLastActive = TRUE);

Parameter

[di] bLastActive

Keterangan

CMFCBaseTabCtrl::EnableAutoColor

Mengontrol apakah kerangka kerja menggunakan warna latar belakang otomatis saat menggambar tab.

void EnableAutoColor(BOOL bEnable = TRUE);

Parameter

bEnable
[di] Parameter Boolean yang menentukan apakah kerangka kerja menggunakan warna otomatis.

Keterangan

Kontrol tab memiliki array beberapa warna yang telah ditentukan sebelumnya. Saat kerangka kerja menggunakan warna otomatis, setiap tab dalam serangkaian tab diberi warna berikutnya dari array ini.

Secara default, warna otomatis ditentukan oleh warna yang ditentukan pustaka. Anda dapat menyediakan array warna kustom dengan memanggil CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::EnableCustomToolTips

Mengaktifkan tipsalat kustom untuk kontrol tab.

BOOL EnableCustomToolTips(BOOL bEnable = TRUE);

Parameter

bEnable
[di] Boolean yang menentukan apakah akan menggunakan tipsalat kustom.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Jika tipsalat kustom diaktifkan, kontrol tab mengirimkan pesan AFX_WM_ON_GET_TAB_TOOLTIP ke bingkai utama. Jika Anda ingin mendukung tipsalat kustom di aplikasi Anda, jendela bingkai utama harus menangani metode ini dan menyediakan teks tipsalat kustom. Untuk informasi selengkapnya tentang menyediakan teks tipsalat kustom, lihat Struktur CMFCTabToolTipInfo.

CMFCBaseTabCtrl::EnableInPlaceEdit

Mengaktifkan pengeditan langsung label tab oleh pengguna.

virtual void EnableInPlaceEdit(BOOL bEnable) = 0;

Parameter

bEnable
[di] Parameter Boolean yang menentukan apakah akan mengaktifkan pengeditan langsung label tab.

Keterangan

Secara default, pengeditan langsung label tab dinonaktifkan untuk kontrol tab.

Anda dapat mengaktifkan pengeditan langsung untuk subset tab pada kontrol tab. Untuk melakukan ini, ambil alih metode CMFCBaseTabCtrl::StartRenameTab. StartRenameTab harus mengembalikan nilai bukan nol untuk semua tab yang mendukung pengeditan langsung label tab.

CMFCBaseTabCtrl ClassDalam , metode ini adalah fungsi virtual murni dan tidak memiliki implementasi. Jika Anda memperoleh kelas dari CMFCBaseTabCtrl, Anda harus menerapkan fungsi ini.

CMFCBaseTabCtrl::EnableTabDetach

Mengaktifkan tab yang dapat dilepas.

virtual BOOL EnableTabDetach(
    int iTab,
    BOOL bEnable);

Parameter

iTab
[di] Indeks berbasis nol tab.

bEnable
[di] Boolean yang menunjukkan apakah akan membuat tab dapat dilepas.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

CMFCBaseTabCtrl::EnableTabSwap

Memungkinkan pengguna mengubah urutan tab menggunakan mouse.

void EnableTabSwap(BOOL bEnable);

Parameter

bEnable
[di] Boolean yang menunjukkan apakah akan mengaktifkan pertukaran tab.

Keterangan

Saat pertukaran tab diaktifkan, pengguna dapat menyeret tab dan mengubah posisi relatifnya di kontrol tab.

CMFCBaseTabCtrl::EnsureVisible

Menggulir tab hingga tab yang ditentukan terlihat.

virtual BOOL EnsureVisible(int iTab);

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Metode ini tidak berpengaruh jika tab yang ditunjukkan oleh iTab sudah terlihat.

Secara default, metode ini tidak didukung oleh CMFCBaseTabCtrl Class. Anda harus menerapkan fungsi ini dalam kelas kustom yang berasal dari CMFCBaseTabCtrl jika kontrol tab kustom tersebut mendukung pengguliran tab. Metode ini didukung oleh Kelas CMFCTabCtrl.

CMFCBaseTabCtrl::EnterDragMode

void EnterDragMode();

Keterangan

CMFCBaseTabCtrl::FindTargetWnd

Mengidentifikasi panel yang berisi titik tertentu.

virtual CWnd* FindTargetWnd(const CPoint& pt) = 0;

Parameter

Pt
[di] Titik yang ditentukan dengan menggunakan koordinat area klien dari objek CMFCBaseTabCtrl .

Tampilkan Nilai

Penunjuk ke objek CWnd jika berhasil; jika tidak, NULL.

Keterangan

CMFCBaseTabCtrl Di kelas , metode ini adalah fungsi virtual murni: Anda harus menerapkannya jika Anda mendapatkan kelas dari CMFCBaseTabCtrl.

CMFCBaseTabCtrl::FireChangeActiveTab

virtual void FireChangeActiveTab(int nNewTab);

Parameter

[di] nNewTab

Keterangan

CMFCBaseTabCtrl::FireChangingActiveTab

virtual BOOL FireChangingActiveTab(int nNewTab);

Parameter

[di] nNewTab

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetActiveTab

Mengambil indeks tab yang saat ini aktif.

virtual int GetActiveTab() const;

Tampilkan Nilai

Indeks berbasis nol dari tab aktif; -1 jika tidak ada tab aktif.

CMFCBaseTabCtrl::GetActiveTabColor

Mengambil warna latar belakang tab yang saat ini aktif.

virtual COLORREF GetActiveTabColor() const;

Tampilkan Nilai

Nilai COLORREF yang menentukan warna latar belakang tab aktif.

Keterangan

Secara default, warna latar belakang tab aktif COLOR_WINDOW. Anda dapat mengubah warna latar belakang untuk tab aktif dengan menggunakan metode CMFCBaseTabCtrl::SetActiveTabColor.

CMFCBaseTabCtrl::GetActiveTabTextColor

Mengambil warna teks untuk tab aktif.

virtual COLORREF GetActiveTabTextColor() const;

Tampilkan Nilai

Nilai COLORREF yang menentukan warna teks tab aktif.

Keterangan

Secara default, warna teks untuk tab aktif COLOR_WINDOWTEXT. Anda dapat mengubah warna teks dengan metode CMFCBaseTabCtrl::SetActiveTabTextColor.

CMFCBaseTabCtrl::GetActiveWnd

Mengambil penunjuk ke jendela tab yang saat ini aktif.

virtual CWnd* GetActiveWnd() const;

Tampilkan Nilai

Penunjuk ke jendela.

CMFCBaseTabCtrl::GetAutoColors

Mengambil array warna yang digunakan untuk pewarnaan otomatis.

const CArray<COLORREF,COLORREF>& GetAutoColors() const;

Tampilkan Nilai

Referensi ke array nilai COLORREF yang digunakan objek CMFCBaseTabCtrl untuk pewarnaan tab otomatis.

Keterangan

Secara default, kerangka kerja menginisialisasi array warna ke warna yang ditentukan pustaka. Anda dapat menyediakan array warna kustom dengan memanggil metode CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::GetFirstVisibleTab

Mengambil penunjuk ke tab pertama yang terlihat.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

virtual CWnd* GetFirstVisibleTab(
    int iStartFrom,
    int& iTabNum);

Parameter

iTabNum
[out] Referensi ke bilangan bulat. Metode ini menulis indeks berbasis nol dari tab pertama yang terlihat ke parameter ini.

iStartFrom
[di] Indeks berbasis nol dari tab pertama untuk diperiksa.

Tampilkan Nilai

Penunjuk ke tab pertama yang terlihat jika berhasil; jika tidak, NULL.

Keterangan

Jika metode ini gagal, metode ini menulis nilai -1 ke iStartFrom.

Jika iStartFrom lebih besar dari atau sama dengan jumlah tab dalam kontrol tab, GetFirstVisibleTab secara otomatis gagal.

CMFCBaseTabCtrl::GetFirstVisibleTabNum

virtual int GetFirstVisibleTabNum() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetHighlightedTab

Mengambil indeks tab yang saat ini disorot.

int GetHighlightedTab() const;

Tampilkan Nilai

Indeks berbasis nol dari tab yang disorot.

CMFCBaseTabCtrl::GetImageList

virtual const CImageList* GetImageList() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetImageSize

virtual CSize GetImageSize() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetLastVisibleTab

virtual CWnd* GetLastVisibleTab(int& iTabNum);

Parameter

[di] iTabNum

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetLocation

Mengambil lokasi bagian area tab kontrol tab.

Location GetLocation() const;

Tampilkan Nilai

Lokasi area tab.

Keterangan

Nilai lokasi area tab yang mungkin LOCATION_BOTTOM dan LOCATION_TOP.

CMFCBaseTabCtrl::GetMaxWindowSize

virtual CSize GetMaxWindowSize() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetTabArea

Mengambil ukuran dan posisi area tab kontrol tab.

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

Parameter

rectTabAreaTop
[di] Referensi ke CRect objek. GetTabArea menggunakan objek ini untuk menyimpan ukuran dan posisi area tab atas.

rectTabAreaBottom
[di] Referensi ke CRect objek. GetTabArea menggunakan objek ini untuk menyimpan ukuran dan posisi area tab bawah.

Keterangan

Setelah GetTabArea kembali, CRect parameter berisi ukuran dan posisi area tab dalam koordinat klien kontrol tab. Jika tidak ada area tab di bagian atas atau bawah kontrol tab, rectTabAreaTop atau rectTabAreaBottom kosong.

CMFCBaseTabCtrl ClassDalam , metode ini adalah fungsi virtual murni dan tidak memiliki implementasi. Jika Anda memperoleh kelas dari CMFCBaseTabCtrl, Anda harus menerapkan fungsi ini.

CMFCBaseTabCtrl::GetTabBkColor

Mengambil warna latar belakang tab yang ditentukan.

virtual COLORREF GetTabBkColor(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

Nilai COLORREF yang menunjukkan warna latar belakang tab yang ditentukan; -1 jika iTab berada di luar rentang.

CMFCBaseTabCtrl::GetTabBorderSize

Mengambil ukuran batas tab dalam kontrol tab.

virtual int GetTabBorderSize() const;

Tampilkan Nilai

Ukuran batas tab, dalam piksel.

Keterangan

Ukuran default untuk batas tab adalah tiga piksel. Anda dapat mengubah ukuran batas ini dengan metode CMFCBaseTabCtrl::SetTabBorderSize.

CMFCBaseTabCtrl::GetTabByID

Mengambil indeks tab berdasarkan ID tab.

virtual int GetTabByID(int id) const;

Parameter

id
[di] ID tab.

Tampilkan Nilai

Indeks berbasis nol tab jika ditemukan; -1 jika ID tab tidak ditemukan.

Keterangan

ID tab ditetapkan secara otomatis saat tab ditambahkan ke kontrol tab.

CMFCBaseTabCtrl::GetTabCloseButton

CRect GetTabCloseButton() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetTabFromHwnd

Mengambil indeks tab yang berisi objek HWND yang ditentukan.

virtual int GetTabFromHwnd(HWND hwnd) const;

Parameter

hwnd
[di] Handel ke jendela.

Tampilkan Nilai

Indeks berbasis nol tab jika berhasil; -1 jika tidak ada tab yang berisi hwnd.

CMFCBaseTabCtrl::GetTabFromPoint

Mengambil tab yang berisi titik tertentu.

virtual int GetTabFromPoint(CPoint& pt) const;

Parameter

Pt
[di] Titik dalam koordinat klien kontrol tab.

Tampilkan Nilai

Indeks tab yang berisi pt; -1 jika tidak ada tab yang berisi pt.

CMFCBaseTabCtrl::GetTabFullWidth

virtual int GetTabFullWidth(int iTab) const;

Parameter

[di] iTab

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetTabHicon

Mengembalikan HICON yang terkait dengan tab yang ditentukan.

virtual HICON GetTabHicon(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol untuk tab .

Tampilkan Nilai

HICON yang terkait dengan label tab jika berhasil; NULL jika tidak ada HICON atau jika metode gagal.

CMFCBaseTabCtrl::GetTabIcon

Mengambil ikon yang terkait dengan tab yang ditentukan.

virtual UINT GetTabIcon(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

ID ikon untuk tab yang ditentukan jika berhasil; -1 jika indeks tidak valid.

Keterangan

Objek CMFCBaseTabCtrl menyimpan ikon di objek CImageList internal.

CMFCBaseTabCtrl::GetTabID

Mengambil ID untuk tab yang ditentukan oleh indeks tab.

int GetTabID(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

ID tab atau -1 jika iTab berada di luar rentang.

CMFCBaseTabCtrl::GetTabLabel

Mengambil teks label tab.

virtual BOOL GetTabLabel(
    int iTab,
    CString& strLabel) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

strLabel
[out] Referensi ke CString objek. Metode ini menyimpan label tab dalam parameter ini.

Tampilkan Nilai

TRUE jika berhasil; FALSE jika tidak.

Keterangan

Metode ini gagal jika iTab indeks tidak valid.

Anda mengatur label untuk tab saat membuat tab dengan menggunakan CMFCBaseTabCtrl::AddTab. Anda juga dapat mengubah label setelah pembuatan dengan metode CMFCBaseTabCtrl::SetTabLabel.

CMFCBaseTabCtrl::GetTabRect

Mengambil ukuran dan posisi tab yang ditentukan.

virtual BOOL GetTabRect(
    int iTab,
    CRect& rect) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

rect
[out] Referensi ke CRect objek. Metode ini menyimpan ukuran dan posisi tab dalam parameter ini.

Tampilkan Nilai

TRUE jika berhasil; FALSE jika indeks tab tidak valid.

CMFCBaseTabCtrl::GetTabsHeight

virtual int GetTabsHeight() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetTabsNum

Mengambil jumlah tab dalam kontrol tab.

virtual int GetTabsNum() const;

Tampilkan Nilai

Jumlah tab dalam kontrol tab.

CMFCBaseTabCtrl::GetTabsRect

virtual void GetTabsRect(CRect& rect) const;

Parameter

[di] rect

Keterangan

CMFCBaseTabCtrl::GetTabTextColor

Mengambil warna teks untuk tab yang ditentukan.

virtual COLORREF GetTabTextColor(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

Parameter COLORREF yang menunjukkan warna teks tab yang ditentukan; -1 jika iTab berada di luar rentang.

CMFCBaseTabCtrl::GetTabWnd

Mengembalikan penunjuk ke panel yang berada di tab yang ditentukan.

virtual CWnd* GetTabWnd(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

Penunjuk ke objek CWnd yang berada di tab yang ditentukan iTab . NULL jika iTab tidak valid.

Keterangan

Objek yang dikembalikan adalah objek yang ditambahkan aplikasi ketika disebut CMFCBaseTabCtrl::AddTab atau CMFCBaseTabCtrl::InsertTab.

Jika objek pada tab memiliki pembungkus, metode ini akan mengembalikan pembungkus untuk objek. Untuk informasi selengkapnya tentang pembungkus, lihat CMFCBaseTabCtrl::CreateWrapper. Jika Anda ingin mengakses penunjuk ke objek langsung tanpa pembungkus, gunakan metode CMFCBaseTabCtrl::GetTabWndNoWrapper.

CMFCBaseTabCtrl::GetTabWndNoWrapper

Mengembalikan penunjuk ke kontrol yang berada pada tab, meskipun kontrol memiliki pembungkus.

virtual CWnd* GetTabWndNoWrapper(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

Penunjuk ke objek CWnd yang berada di tab yang ditentukan; NULL jika iTab tidak valid.

Keterangan

Metode ini mengambil penunjuk langsung ke CWnd objek yang Anda tambahkan dengan menggunakan metode CMFCBaseTabCtrl::AddTab atau CMFCBaseTabCtrl::InsertTab. GetTabWndNoWrapper akan mengambil penunjuk ke yang ditambahkan CWnd, bahkan jika kerangka kerja menambahkan pembungkus untuk objek. Untuk informasi selengkapnya tentang pembungkus dan Kelas CMFCBaseTabCtrl, lihat CMFCBaseTabCtrl::CreateWrapper.

Gunakan metode CMFCBaseTabCtrl::GetTabWnd jika Anda tidak ingin mengabaikan kelas pembungkus.

CMFCBaseTabCtrl::GetToolTipCtrl

Mengambil referensi ke tooltip contorl.

CToolTipCtrl& GetToolTipCtrl() const;

Tampilkan Nilai

Referensi ke kontrol tipsalat.

CMFCBaseTabCtrl::GetVisibleTabsNum

Mengambil jumlah tab yang terlihat saat ini.

virtual int GetVisibleTabsNum() const;

Tampilkan Nilai

Jumlah tab yang terlihat.

CMFCBaseTabCtrl::HasImage

virtual BOOL HasImage(int iTab) const;

Parameter

[di] iTab

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::HideSingleTab

Mengatur opsi untuk menyembunyikan tab untuk kontrol tab saat ada satu tab yang terlihat.

virtual void HideSingleTab(BOOL bHide = TRUE);

Parameter

bHide
[di] Boolean yang menentukan apakah akan mengaktifkan menyembunyikan tab tunggal.

Keterangan

Saat aplikasi Anda dikonfigurasi untuk menyembunyikan tab tunggal, kerangka kerja secara otomatis menampilkan tab saat tab kedua ditambahkan ke kontrol tab.

CMFCBaseTabCtrl::InsertTab

Menyisipkan tab ke dalam kontrol tab.

Virtual void InsertTab(
    CWnd* pNewWnd,
    LPCTSTR lpszTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void InsertTab(
    CWnd* pNewWnd,
    UINT uiResTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parameter

pNewWnd
[di] Penunjuk ke jendela yang ditambahkan metode ini sebagai tab baru.

lpszTabLabel
[di] String yang berisi label untuk tab baru.

nInsertAt
[di] Indeks berbasis nol dari tab baru.

uiImageId
[di] ID gambar dari daftar gambar. Kontrol tab menggunakan gambar ini sebagai ikon untuk tab baru.

bDetachable
[di] Parameter Boolean yang menentukan apakah tab baru dapat dilepas.

uiResTabLabel
[di] ID sumber daya untuk label.

Keterangan

Jika objek yang ditunjukkan oleh pNewWnd tidak berasal dari Kelas CDockablePane dan jika parameter bDetachable TRUE, kerangka kerja membuat pembungkus khusus untuk tab baru. Secara default, pembungkus adalah instans Kelas CDockablePaneAdapter. Gunakan metode CMFCBaseTabCtrl::SetDockingBarWrapperRTC untuk membuat kelas pembungkus yang berbeda. Setiap kelas pembungkus kustom perlu berasal dari CDockablePaneAdapter.

CMFCBaseTabCtrl::InvalidateTab

void InvalidateTab(int iTab);

Parameter

[di] iTab

Keterangan

CMFCBaseTabCtrl::IsActiveTabCloseButton

virtual BOOL IsActiveTabCloseButton() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsAutoColor

Menentukan apakah kontrol tab berada dalam mode pewarnaan otomatis.

BOOL IsAutoColor() const;

Tampilkan Nilai

TRUE jika kontrol tab dalam mode pewarnaan otomatis; FALSE jika tidak.

Keterangan

Anda dapat mengaktifkan atau menonaktifkan mode warna otomatis dengan menggunakan metode CMFCBaseTabCtrl::EnableAutoColor .

CMFCBaseTabCtrl::IsAutoDestroyWindow

BOOL IsAutoDestroyWindow() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsColored

virtual BOOL IsColored() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsDialogControl

BOOL IsDialogControl() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsDrawNoPrefix

BOOL IsDrawNoPrefix() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsFlatFrame

Menunjukkan apakah bingkai kontrol tab dirender dalam gaya datar atau dalam gaya 3D.

virtual BOOL IsFlatFrame() const;

Tampilkan Nilai

TRUE jika bingkai kontrol tab dirender dalam gaya datar; FALSE jika bingkai dirender dalam gaya 3D.

Keterangan

Gunakan CMFCTabCtrl::SetFlatFrame untuk mengubah gaya bingkai kontrol tab.

Kontrol tab yang menggunakan gaya Outlook tidak dapat dirender dengan bingkai datar. Ini termasuk Kelas CMFCOutlookBarTabCtrl dan kelas apa pun yang berasal dari kelas tersebut.

CMFCBaseTabCtrl::IsFlatTab

virtual BOOL IsFlatTab() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsHideSingleTab

Menentukan apakah kontrol tab menyembunyikan label tab jika hanya ada satu tab.

virtual BOOL IsHideSingleTab() const;

Tampilkan Nilai

TRUE jika kontrol tab menyembunyikan label tab saat memiliki satu tab; jika tidak FALSE.

Keterangan

Gunakan metode CMFCBaseTabCtrl::HideSingleTab untuk mengaktifkan menyembunyikan label tab saat hanya ada satu tab.

CMFCBaseTabCtrl::IsIconAdded

BOOL IsIconAdded(
    HICON hIcon,
    int& iIcon);

Parameter

[di] hIcon

[di] iIcon

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsInPlaceEdit

Menunjukkan apakah kontrol tab dikonfigurasi untuk memungkinkan pengguna mengubah label tab secara dinamis.

virtual BOOL IsInPlaceEdit() const;

Tampilkan Nilai

Bukan nol jika pengeditan di tempat diaktifkan; jika tidak, 0.

Keterangan

Anda dapat mengaktifkan atau menonaktifkan pengeditan di tempat dengan memanggil metode CMFCBaseTabCtrl::EnableInPlaceEdit.

CMFCBaseTabCtrl::IsLeftRightRounded

virtual BOOL IsLeftRightRounded() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsMDITab

BOOL IsMDITab() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsOneNoteStyle

Menentukan apakah tab ditampilkan dalam gaya Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Tampilkan Nilai

TRUE jika tab ditampilkan dalam gaya Microsoft OneNote; jika tidak FALSE.

Keterangan

Panggil metode CMDIFrameWndEx::EnableMDITabs untuk mengaktifkan gaya Microsoft OneNote. Anda juga dapat mengaktifkan gaya ini saat membuat instans Kelas CMFCTabCtrl: cukup teruskan gaya STYLE_3D_ONENOTE ke metode CMFCTabCtrl::Create.

Secara default, gaya Microsoft OneNote tidak didukung di kelas kustom yang berasal dari CMFCBaseTabCtrl Class. Namun, ini didukung di CMFCTabCtrl kelas .

CMFCBaseTabCtrl::IsPtInTabArea

Menentukan apakah titik berada di dalam area tab.

virtual BOOL IsPtInTabArea(CPoint point) const = 0;

Parameter

ujung
[di] Titik untuk diuji.

Tampilkan Nilai

Bukan nol jika titik berada di area tab; 0 jika tidak.

Keterangan

CMFCBaseTabCtrl ClassDalam , metode ini adalah fungsi virtual murni dan tidak memiliki implementasi. Jika Anda memperoleh kelas dari CMFCBaseTabCtrl, Anda harus menerapkan fungsi ini.

CMFCBaseTabCtrl::IsTabCloseButtonHighlighted

BOOL IsTabCloseButtonHighlighted() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsTabCloseButtonPressed

BOOL IsTabCloseButtonPressed() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::IsTabDetachable

Menentukan apakah tab dapat dilepas.

virtual BOOL IsTabDetachable(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol dari tab untuk diperiksa.

Tampilkan Nilai

TRUE jika tab dapat dilepas; FALSE jika tidak.

Keterangan

Untuk membuat tab dapat dilepas, gunakan metode CMFCBaseTabCtrl::EnableTabDetach.

CMFCBaseTabCtrl::IsTabIconOnly

Menentukan apakah label tab hanya berisi ikon dan tanpa teks.

virtual BOOL IsTabIconOnly(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

TRUE jika label tab hanya memiliki ikon; FALSE jika tidak.

Keterangan

Untuk mengatur tab di aplikasi Anda agar hanya menampilkan ikon, panggil metode CMFCBaseTabCtrl::SetTabIconOnly.

CMFCBaseTabCtrl::IsTabSwapEnabled

Menentukan apakah kontrol tab memungkinkan pengguna mengubah posisi tab dengan menggunakan mouse.

BOOL IsTabSwapEnabled() const;

Tampilkan Nilai

Nonzero jika posisi tab dapat diubah oleh pengguna; jika tidak, 0.

Keterangan

Secara default, pengguna tidak dapat mengubah urutan tab dalam kontrol tab. Gunakan metode CMFCBaseTabCtrl::EnableTabSwap untuk mengaktifkan fungsionalitas ini.

CMFCBaseTabCtrl::IsTabVisible

Menunjukkan apakah tab yang ditentukan terlihat.

virtual BOOL IsTabVisible(int iTab) const;

Parameter

iTab
[di] Indeks berbasis nol dari tab untuk diperiksa.

Tampilkan Nilai

Bukan nol jika tab yang ditentukan terlihat; jika tidak, 0.

CMFCBaseTabCtrl::IsVS2005Style

virtual BOOL IsVS2005Style() const;

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::m_bActivateTabOnRightClick

m_bActivateTabOnRightClick menentukan apakah tab berada dalam fokus saat pengguna mengklik label tab dengan menggunakan tombol kanan mouse.

BOOL m_bActivateTabOnRightClick;

Keterangan

Nilai default untuk anggota data ini adalah FALSE.

CMFCBaseTabCtrl::m_bAutoDestroyWindow

m_bAutoDestroyWindow menentukan apakah kerangka kerja secara otomatis menghancurkan objek pada tab saat tab dihapus.

BOOL m_bAutoDestroyWindow;

Keterangan

Secara default, anggota ini adalah FALSE.

CMFCBaseTabCtrl::MoveTab

virtual void MoveTab(
    int nSource,
    int nDest);

Parameter

[di] nSource

[di] nDest

Keterangan

CMFCBaseTabCtrl::OnChangeTabs

Kerangka kerja memanggil metode ini ketika jumlah tab pada kontrol tab berubah.

virtual void OnChangeTabs();

Keterangan

Secara default, metode ini tidak melakukan apa pun. Ambil alih metode ini untuk menjalankan kode kustom ketika jumlah tab pada kontrol tab berubah.

CMFCBaseTabCtrl::OnDrop

virtual BOOL OnDrop(
    COleDataObject*,
    DROPEFFECT,
    CPoint);

Parameter

[di] COleDataObject*

[di] DROPEFFECT

[di] CPoint

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::OnDragOver

virtual DROPEFFECT OnDragOver(
    COleDataObject*,
    DWORD,
    CPoint);

Parameter

[di] COleDataObject*

[di] DWORD

[di] CPoint

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::OnDragLeave

virtual void OnDragLeave();

Keterangan

CMFCBaseTabCtrl::OnDragEnter

virtual DROPEFFECT OnDragEnter(
    COleDataObject*,
    DWORD,
    CPoint);

Parameter

[di] COleDataObject*

[di] DWORD

[di] CPoint

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::OnRenameTab

virtual BOOL OnRenameTab(int, CString&);

Parameter

[di] Int

[di] CString&

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameter

[di] pMsg

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::RecalcLayout

Menghitung ulang tata letak internal kontrol tab.

virtual void RecalcLayout() = 0;

Keterangan

CMFCBaseTabCtrl ClassDalam , metode ini adalah fungsi virtual murni. Jika Anda memperoleh kelas dari CMFCBaseTabCtrl, Anda harus menerapkan fungsi ini.

CMFCBaseTabCtrl::RemoveAllTabs

Menghapus semua tab dari kontrol tab.

virtual void RemoveAllTabs();

Keterangan

Jika CMFCBaseTabCtrl::m_bAutoDestroyWindow TRUE, kerangka kerja akan menghapus semua objek CWnd yang dilampirkan ke tab yang dihapus.

CMFCBaseTabCtrl::RemoveTab

Menghapus tab dari kontrol tab.

virtual BOOL RemoveTab(
    int iTab,
    BOOL bRecalcLayout = TRUE);

Parameter

iTab
[di] Indeks berbasis nol tab.

bRecalcLayout
[di] Parameter Boolean yang menentukan apakah akan menghitung ulang tata letak tab.

Tampilkan Nilai

TRUE jika metode berhasil menghapus tab; jika tidak FALSE.

Keterangan

Jika CMFCBaseTabCtrl::m_bAutoDestroyWindow TRUE, RemoveTab menghancurkan objek CWnd yang terkait dengan tab yang ditentukan.

CMFCBaseTabCtrl::RenameTab

virtual BOOL RenameTab();

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::ResetImageList

Mengatur ulang daftar gambar untuk instans Kelas CMFCBaseTabCtrl.

void ResetImageList();

CMFCBaseTabCtrl::Serialize

virtual void Serialize(CArchive& ar);

Parameter

[di] Ar

Keterangan

CMFCBaseTabCtrl::SetActiveTab

Mengaktifkan tab yang ditentukan.

virtual BOOL SetActiveTab(int iTab) = 0;

Parameter

iTab
[di] Indeks berbasis nol tab. SetActiveTab membuat tab dengan indeks ini aktif.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

CMFCBaseTabCtrl ClassDalam , metode ini adalah fungsi virtual murni. Jika Anda memperoleh kelas dari CMFCBaseTabCtrl, Anda harus menerapkan fungsi ini.

CMFCBaseTabCtrl::SetActiveTabColor

Mengatur warna latar belakang untuk tab aktif.

virtual void SetActiveTabColor(COLORREF clr);

Parameter

Clr
[di] Menentukan warna latar belakang baru.

Keterangan

Kerangka kerja memperoleh warna latar belakang default untuk tab aktif dari metode GetSysColor.

CMFCBaseTabCtrl::SetActiveTabTextColor

Mengatur warna teks untuk tab aktif.

virtual void SetActiveTabTextColor(COLORREF clr);

Parameter

Clr
[di] Parameter COLORREF yang menentukan warna teks baru.

Keterangan

Secara default, kerangka kerja mendapatkan warna teks dari GetSysColor. Ambil alih warna default ini dengan menggunakan SetActiveTabTextColor metode .

CMFCBaseTabCtrl::SetAutoColors

Mengatur warna kontrol tab yang digunakan kerangka kerja dalam mode warna otomatis.

void SetAutoColors(const CArray<COLORREF,COLORREF>& arColors);

Parameter

arColors
[di] Array warna RGB.

Keterangan

Jika Anda menyediakan array warna kustom, array warna default diabaikan. Jika parameter arColors kosong, kerangka kerja akan kembali ke array warna default.

Untuk mengaktifkan mode autocolor, gunakan metode CMFCBaseTabCtrl::EnableAutoColor .

CMFCBaseTabCtrl::SetDockingBarWrapperRTC

Mengatur kelas pembungkus yang digunakan untuk objek apa pun yang tidak berasal dari Kelas CDockablePane.

void SetDockingBarWrapperRTC(CRuntimeClass* pRTC);

Parameter

pRTC
[di] Informasi kelas runtime untuk kelas pembungkus baru.

Keterangan

Anda menambahkan tab ke kontrol tab dengan menggunakan metode CMFCBaseTabCtrl::AddTab dan CMFCBaseTabCtrl::InsertTab. Saat Anda menambahkan tab, setiap kontrol pada tab tersebut harus dapat di-dock. Objek apa pun yang tidak berasal dari CDockablePane harus dibungkus. AddTab dan InsertTab buat pembungkus untuk objek ini. Kelas pembungkus default adalah Kelas CDockablePaneAdapter. Metode SetDockingBarWrapperRTC ini memungkinkan Anda mengubah kelas yang digunakan sebagai kelas pembungkus. Kelas pembungkus yang Anda sediakan harus berasal dari CDockablePaneAdapter.

CMFCBaseTabCtrl::SetDrawNoPrefix

Mengaktifkan dan menonaktifkan pemrosesan karakter awalan dalam label tab.

void SetDrawNoPrefix(
    BOOL bNoPrefix,
    BOOL bRedraw = TRUE);

Parameter

bNoPrefix
[di] TRUE jika Anda ingin memproses karakter awalan; jika tidak FALSE.

bRedraw
[di] TRUE jika Anda ingin menggambar ulang jendela bertab; jika tidak FALSE.

Keterangan

Karakter awalan adalah karakter mnemonic yang didahului oleh ampersand (&&).

CMFCBaseTabCtrl::SetImageList

Mengatur daftar gambar ikon untuk kontrol tab.

virtual BOOL SetImageList(
    UINT uiID,
    int cx = 15,
    COLORREF clrTransp = RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parameter

uiID
[di] ID sumber daya bitmap. SetImageList memuat daftar gambar dari sumber daya ini.

cx
[di] Lebar setiap gambar dalam piksel.

clrTransp
[di] Parameter COLORREF yang menunjukkan warna transparan gambar.

hImageList
[di] Handel ke daftar gambar yang telah dimuat sebelumnya.

Tampilkan Nilai

Bukan nol jika metode berhasil; 0 jika tidak.

Keterangan

Gambar dari daftar gambar ikon ditampilkan bersama label untuk tab. Untuk menampilkan ikon, Anda harus menentukan indeksnya saat memanggil CMFCBaseTabCtrl::AddTab.

SetImageList akan gagal jika kontrol tab dibuat dengan gaya datar. Ini juga akan gagal jika kerangka kerja tidak dapat memuat gambar yang ditunjukkan oleh uiID.

Metode ini menghitung ulang tinggi tab sesuai dengan ukuran gambar dan teks.

CMFCBaseTabCtrl::SetLocation

virtual void SetLocation(Location location);

Parameter

[di] tempat

Keterangan

CMFCBaseTabCtrl::SetTabBkColor

Mengatur warna latar belakang untuk tab yang ditentukan.

virtual BOOL SetTabBkColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parameter

iTab
[di] Indeks berbasis nol tab.

warna
[di] Warna yang akan diatur.

Tampilkan Nilai

TRUE jika berhasil; FALSE jika tidak.

CMFCBaseTabCtrl::SetTabBorderSize

Mengatur ukuran batas baru untuk kontrol tab.

virtual void SetTabBorderSize(
    int nTabBorderSize,
    BOOL bRepaint = TRUE);

Parameter

nTabBorderSize
[di] Ukuran batas baru, dalam piksel.

bRepaint
[di] Parameter Boolean yang menunjukkan apakah kerangka kerja menggambar ulang kontrol.

CMFCBaseTabCtrl::SetTabHicon

Mengatur ikon untuk label tab.

virtual BOOL SetTabHicon(
    int iTab,
    HICON hIcon);

Parameter

iTab
[di] Indeks berbasis nol tab. Metode ini mengubah ikon untuk tab ini.

hIcon
[di] Handel ke ikon.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

CMFCBaseTabCtrl::SetTabIcon

Mengatur ikon untuk tab.

virtual BOOL SetTabIcon(
    int iTab,
    UINT uiIcon);

Parameter

iTab
[di] Indeks berbasis nol tab yang akan diperbarui.

uiIcon
[di] ID ikon untuk ikon baru. ID ini mereferensikan objek CImageList internal.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

CMFCBaseTabCtrl::SetTabIconOnly

Mengaktifkan hanya menampilkan ikon (dan tanpa label teks) pada tab tertentu.

virtual BOOL SetTabIconOnly(
    int iTab,
    BOOL bIconOnly = TRUE,
    BOOL bShowTooltipAlways = FALSE);

Parameter

iTab
[di] Indeks berbasis nol tab yang akan diubah.

bIconOnly
[di] Parameter Boolean yang menentukan apakah hanya menampilkan ikon.

bShowTooltipAlways
[di] Parameter Boolean yang menentukan apakah kerangka kerja menampilkan tipsalat untuk label tab yang hanya menampilkan ikon.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Secara default, kontrol tab menampilkan ikon dan label teks untuk setiap tab.

CMFCBaseTabCtrl::SetTabLabel

Mengatur teks untuk label tab.

virtual BOOL SetTabLabel(
    int iTab,
    const CString& strLabel);

Parameter

iTab
[di] Indeks berbasis nol tab yang akan diperbarui.

strLabel
[di] Referensi ke string yang berisi teks baru untuk label tab.

Tampilkan Nilai

Bukan nol jika berhasil; 0 jika tidak.

CMFCBaseTabCtrl::SetTabsHeight

virtual void SetTabsHeight();

Keterangan

CMFCBaseTabCtrl::SetTabsOrder

Mengatur tab dalam urutan yang ditentukan.

BOOL SetTabsOrder(const CArray<int,int>& arOrder);

Parameter

arOrder
[di] Array indeks berbasis nol yang menentukan urutan tab baru.

Tampilkan Nilai

TRUE jika berhasil; GAGAL jika tidak.

Keterangan

Ukuran array arOrder harus sama dengan jumlah tab dalam kontrol tab.

CMFCBaseTabCtrl::SetTabTextColor

Mengatur warna teks untuk tab tertentu.

virtual BOOL SetTabTextColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parameter

iTab
[di] Indeks berbasis nol tab.

warna
[di] Parameter COLORREF yang menunjukkan warna teks baru.

Tampilkan Nilai

Bukan nol jika berhasil; 0 jika tidak.

CMFCBaseTabCtrl::ShowTab

Memperlihatkan atau menyembunyikan tab yang ditentukan.

virtual BOOL ShowTab(
    int iTab,
    BOOL bShow = TRUE,
    BOOL bRecalcLayout = TRUE,
    BOOL bActivate = FALSE);

Parameter

iTab
[di] Indeks tab yang ShowTab akan ditampilkan atau disembunyikan.

bShow
[di] Parameter Boolean yang menunjukkan apakah akan menampilkan tab.

bRecalcLayout
[di] Parameter Boolean yang menunjukkan apakah akan segera menghitung ulang tata letak jendela.

bActivate
[di] Parameter Boolean yang menunjukkan apakah akan memilih tab yang ditentukan oleh iTab.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Parameter bActivate hanya berlaku jika bShow TRUE. Jika bActivate TRUE dan jika ShowTab berhasil, ShowTab akan mengirim pesan AFX_WM_CHANGE_ACTIVE_TAB ke induk jendela tab.

CMFCBaseTabCtrl::StartRenameTab

virtual BOOL StartRenameTab(int iTab);

Parameter

[di] iTab

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::SwapTabs

virtual void SwapTabs(
    int nFisrtTabID,
    int nSecondTabID);

Parameter

[di] nFisrtTabID

[di] nSecondTabID

Keterangan

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCTabCtrl
Kelas CMFCOutlookBarTabCtrl

Bagikan melalui

Kelas CMFCBaseTabCtrl

Sintaks

Anggota

Metode Publik

Metode yang Dilindungi

Anggota Data

Keterangan

Tips Kustomisasi

Hierarki Warisan

Persyaratan

CMFCBaseTabCtrl::AddIcon

Parameter

Keterangan

CMFCBaseTabCtrl::AddTab

Parameter

Keterangan

CMFCBaseTabCtrl::ApplyRestoredTabInfo

Parameter

Keterangan

CMFCBaseTabCtrl::AutoDestroyWindow

Parameter

Keterangan

CMFCBaseTabCtrl::CalcRectEdit

Parameter

Keterangan

CMFCBaseTabCtrl::CleanUp

Keterangan

CMFCBaseTabCtrl::ClearImageList

Keterangan

CMFCBaseTabCtrl::CreateWrapper

Parameter

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::D etachTab

Parameter

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::EnableActivateLastActive

Parameter

Keterangan

CMFCBaseTabCtrl::EnableAutoColor

Parameter

Keterangan

CMFCBaseTabCtrl::EnableCustomToolTips

Parameter

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::EnableInPlaceEdit

Parameter

Keterangan

CMFCBaseTabCtrl::EnableTabDetach

Parameter

Tampilkan Nilai

CMFCBaseTabCtrl::EnableTabSwap

Parameter

Keterangan

CMFCBaseTabCtrl::EnsureVisible

Parameter

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::EnterDragMode

Keterangan

CMFCBaseTabCtrl::FindTargetWnd

Parameter

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::FireChangeActiveTab

Parameter

Keterangan

CMFCBaseTabCtrl::FireChangingActiveTab

Parameter

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetActiveTab

Tampilkan Nilai

CMFCBaseTabCtrl::GetActiveTabColor

Tampilkan Nilai

Keterangan

CMFCBaseTabCtrl::GetActiveTabTextColor