Bagikan melalui

CMFCTabCtrl Kelas

  • Artikel

Kelas menyediakan CMFCTabCtrl fungsionalitas untuk kontrol tab. Kontrol tab menampilkan jendela yang dapat di-dok dengan tab datar atau tiga dimensi di bagian atas atau bawahnya. Tab dapat menampilkan teks dan gambar dan dapat mengubah warna saat aktif.

Sintaks

class CMFCTabCtrl : public CMFCBaseTabCtrl

Anggota

Konstruktor Publik

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

Metode Publik

Nama Deskripsi
CMFCTabCtrl::ActivateMDITab Menampilkan tab yang ditentukan dari kontrol tab saat ini dan mengatur fokus pada tab tersebut.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Menentukan apakah kerangka kerja akan mengubah ukuran area klien dari semua jendela kontrol tab saat elemen antarmuka pengguna kontrol tab berubah.
CMFCTabCtrl::CalcRectEdit Mengempis ukuran area tab yang ditentukan. (Ambil alih CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::Create Membuat kontrol tab dan melampirkannya ke CMFCTabCtrl objek.
CMFCTabCtrl::CreateObject Digunakan oleh kerangka kerja untuk membuat instans dinamis dari jenis kelas ini.
CMFCTabCtrl::EnableActiveTabCloseButton Memperlihatkan atau menyembunyikan tombol Tutup ( X) pada tab aktif.
CMFCTabCtrl::EnableInPlaceEdit Mengaktifkan atau menonaktifkan label tab yang dapat diedit. (Mengambil alih CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu Mengganti dua tombol yang menggulir tab jendela dengan tombol yang membuka menu jendela bertab.
CMFCTabCtrl::EnsureVisible Memastikan bahwa tab terlihat.
CMFCTabCtrl::GetDocumentIcon Mengambil simbol yang terkait dengan tab di menu popup jendela bertab.
CMFCTabCtrl::GetFirstVisibleTabNum Mengambil indeks tab pertama yang terlihat di kontrol tab saat ini.
CMFCTabCtrl::GetResizeMode Mengambil nilai yang menentukan bagaimana kontrol tab saat ini dapat diubah ukurannya.
CMFCTabCtrl::GetScrollBar Mengambil penunjuk ke objek bilah gulir yang terkait dengan kontrol tab.
CMFCTabCtrl::GetTabArea Mengambil persegi panjang pembatas area label tab di bagian atas atau bawah kontrol tab. (Mengambil alih CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint Mengambil tab yang berisi titik tertentu. (Mengambil alih CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth Mengambil lebar maksimum tab.
CMFCTabCtrl::GetTabsHeight Mengambil tinggi area tab kontrol tab saat ini.
CMFCTabCtrl::GetTabsRect Mengambil persegi panjang yang mengikat area tab kontrol tab saat ini. (Mengambil alih CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke CRuntimeClass objek yang terkait dengan jenis kelas ini.
CMFCTabCtrl::GetWndArea Mengambil batas area klien dari kontrol tab saat ini.
CMFCTabCtrl::HideActiveWindowHorzScrollBar Menyembunyikan bilah gulir horizontal, jika ada, dari jendela aktif.
CMFCTabCtrl::HideInactiveWindow Menentukan apakah kerangka kerja akan menampilkan jendela kontrol tab yang tidak aktif.
CMFCTabCtrl::HideNoTabs Mengaktifkan atau menonaktifkan menggambar area tab jika tidak ada tab yang terlihat.
CMFCTabCtrl::HideSingleTab Mengaktifkan atau menonaktifkan menggambar tab saat ada satu jendela bertab. (Mengambil alih CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup Menunjukkan apakah tab kontrol tab saat ini adalah tab aktif dalam grup tab antarmuka beberapa dokumen.
CMFCTabCtrl::IsActiveTabBoldFont Menunjukkan apakah teks tab aktif ditampilkan menggunakan font tebal.
CMFCTabCtrl::IsActiveTabCloseButton Menunjukkan apakah tombol Tutup ( X) ditampilkan pada tab aktif atau sudut kanan atas area tab.
CMFCTabCtrl::IsDrawFrame Menunjukkan apakah jendela bertab menggambar persegi panjang bingkai di sekitar panel yang disematkan.
CMFCTabCtrl::IsFlatFrame Menunjukkan apakah bingkai di sekitar area tab datar atau 3D.
CMFCTabCtrl::IsFlatTab Menunjukkan apakah tampilan tab di kontrol tab saat ini datar atau tidak.
CMFCTabCtrl::IsLeftRightRounded Menunjukkan apakah tampilan sisi kiri dan kanan tab di kontrol tab saat ini dibulatkan.
CMFCTabCtrl::IsMDITabGroup Menunjukkan apakah kontrol tab saat ini terkandung di area klien dari jendela antarmuka beberapa dokumen.
CMFCTabCtrl::IsOneNoteStyle Menunjukkan apakah kontrol tab saat ini ditampilkan dalam gaya Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea Menentukan apakah titik berada di dalam area tab. (Mengambil alih CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll Menunjukkan apakah kontrol tab saat ini memiliki bilah gulir yang dapat menggulir tabnya sebagai grup.
CMFCTabCtrl::IsTabDocumentsMenu Menunjukkan apakah kontrol tab menampilkan tombol gulir atau tombol yang menampilkan menu jendela bertab.
CMFCTabCtrl::IsVS2005Style Menunjukkan apakah tab ditampilkan dalam gaya Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle Menentukan tampilan tab di kontrol tab saat ini.
CMFCTabCtrl::MoveTab Memindahkan tab ke posisi tab lain. (Mengambil alih CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter Dipanggil oleh kerangka kerja saat kursor pertama kali diseret ke jendela kontrol tab.
CMFCTabCtrl::OnDragOver Dipanggil oleh kerangka kerja selama operasi seret saat mouse dipindahkan ke jendela target drop. (Mengambil alih CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu Menampilkan menu popup jendela bertab, menunggu hingga pengguna memilih tab, dan menjadikan tab yang dipilih sebagai tab aktif.
CMFCTabCtrl::PreTranslateMessage Menerjemahkan pesan jendela sebelum dikirim ke TranslateMessage fungsi Windows dan DispatchMessage . (Mengambil alih CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout Menghitung ulang tata letak internal kontrol tab. (Mengambil alih CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup Mengatur tab saat ini dari kontrol tab sebagai tab aktif dalam grup tab antarmuka beberapa dokumen.
CMFCTabCtrl::SetActiveTab Mengaktifkan tab. (Ambil alih CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Mengaktifkan atau menonaktifkan penggunaan font tebal pada tab aktif.
CMFCTabCtrl::SetDrawFrame Mengaktifkan atau menonaktifkan menggambar persegi panjang bingkai di sekitar bilah yang disematkan.
CMFCTabCtrl::SetFlatFrame Menentukan apakah akan menggambar bingkai datar atau 3D di sekitar area tab.
CMFCTabCtrl::SetImageList Menentukan daftar gambar. (Mengambil alih CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode Menentukan bagaimana kontrol tab saat ini dapat diubah ukurannya lalu memutar ulang kontrol.
CMFCTabCtrl::SetTabMaxWidth Menentukan lebar tab maksimum dalam jendela bertab.
CMFCTabCtrl::StopResize Mengakhiri operasi mengubah ukuran saat ini pada kontrol tab.
CMFCTabCtrl::SwapTabs Menukar sepasang tab. (Mengambil alih CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar Menggambar bilah gulir horizontal pada kontrol tab yang menampilkan tab datar.

Anggota Data

Nama Deskripsi
CMFCTabCtrl::m_bEnableActivate Mencegah tampilan aktif kehilangan fokus saat tab baru disisipkan dan diaktifkan.

Keterangan

Kelas CMFCTabCtrl ini mendukung:

  • Gaya kontrol tab yang menyertakan 3D, datar, dan datar dengan bilah gulir horizontal bersama.

  • Tab yang terletak di bagian atas atau bagian bawah jendela.

  • Tab yang menampilkan teks, gambar, atau teks dan gambar.

  • Tab yang berubah warna saat tab aktif.

  • Perubahan ukuran batas untuk tab yang dapat disesuaikan.

  • Jendela bertab yang dapat dilepas.

Kelas CMFCTabCtrl dapat digunakan dengan kotak dialog, tetapi ditujukan untuk aplikasi yang menggunakan bilah kontrol docking seperti Microsoft Excel dan Visual Studio. Untuk informasi selengkapnya, lihat CDockablePane Kelas.

Ikuti langkah-langkah ini untuk menambahkan kontrol tab docking yang dapat diubah besar di aplikasi Anda:

  1. Buat instans CTabbedPane Kelas.

  2. Panggil CDockablePane::Create.

  3. Gunakan CBaseTabbedPane::AddTab atau CMFCBaseTabCtrl::InsertTab untuk menambahkan tab baru.

  4. Panggil CBasePane::EnableDocking agar kontrol tab docking saat ini dapat merapat di jendela bingkai utama.

  5. Panggil CFrameWndEx::DockPane untuk menambungkan jendela bertab di bingkai utama.

Untuk contoh cara membuat jendela bertab sebagai bilah kontrol docking, lihat CTabbedPane Kelas. Untuk menggunakan CMFCTabCtrl sebagai kontrol non-docking, buat CMFCTabCtrl objek lalu panggil CMFCTabCtrl::Create.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCTabCtrl kelas untuk mengonfigurasi CMFCTabCtrl objek. Contoh menjelaskan cara menambahkan tab, memperlihatkan tombol Tutup pada tab aktif, mengaktifkan label tab yang dapat diedit, dan menampilkan menu pop-up label jendela bertab. Contoh ini adalah bagian dari sampel Kumpulan Status.

CMFCTabCtrl m_wndTabs;

// Attach list windows to tab:
// CListCtrl m_wndList1
// CListCtrl m_wndList2
// CListCtrl m_wndList3
m_wndTabs.AddTab(&m_wndList1, _T("Output 1"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList2, _T("Output 2"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList3, _T("Output 3"), (UINT)-1);

m_wndTabs.EnableActiveTabCloseButton();
m_wndTabs.EnableInPlaceEdit(true);
m_wndTabs.EnableTabDocumentsMenu();
m_wndTabs.SetActiveTab(1);
m_wndTabs.SetDrawFrame();
m_wndTabs.SetFlatFrame();

Persyaratan

Header: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Menampilkan tab yang ditentukan dari kontrol tab saat ini dan mengatur fokus pada tab tersebut.

void ActivateMDITab(int nTab = -1);

Parameter

nTab
[di] Indeks berbasis nol dari tab yang akan ditampilkan, atau -1 untuk menentukan tab yang saat ini aktif.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Untuk detail selengkapnya, lihat kode sumber yang mfc terletak di folder penginstalan Visual Studio Anda. Contohnya,%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Tampilkan Nilai

Selalu TRUE.

Keterangan

CMFCTabCtrl::AutoSizeWindow

Menentukan apakah kerangka kerja akan mengubah ukuran area klien dari semua jendela kontrol tab saat elemen antarmuka pengguna kontrol tab berubah.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parameter

bAutoSize
[di] TRUE untuk mengubah ukuran jendela kontrol tab secara otomatis; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Keterangan

CMFCTabCtrl::Create

Membuat kontrol tab dan melampirkannya ke CMFCTabCtrl objek.

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Parameter

style
[di] Gaya kontrol tab. Untuk informasi selengkapnya, lihat Keterangan.

rect
[di] Persegi panjang yang mengikat kontrol tab.

pParentWnd
[di] Penunjuk ke jendela induk. Tidak boleh NULL.

nID
[di] ID kontrol tab.

location
[di] Lokasi tab. Nilai defaultnya adalah LOCATION_BOTTOM. Untuk informasi selengkapnya, lihat Keterangan.

bCloseBtn
[di] TRUE untuk menampilkan tombol tutup pada tab; jika tidak, FALSE. Nilai defaultnya adalah FALSE.

Tampilkan Nilai

TRUE jika berhasil; jika tidak, FALSE.

Keterangan

Tabel berikut ini menjelaskan nilai yang bisa Anda tentukan style untuk parameter .

Gaya Deskripsi
STYLE_3D Membuat kontrol tab dengan tampilan tiga dimensi.
STYLE_FLAT Membuat kontrol tab dengan tab datar.
STYLE_FLAT_SHARED_HORZ_SCROLL Membuat kontrol tab dengan tab datar dan bilah gulir yang dapat menggulir tab jika diklip oleh jendela induk.
STYLE_3D_ONENOTE Membuat kontrol tab dalam gaya Microsoft OneNote.
STYLE_3D_VS2005 Membuat kontrol tab dengan gaya Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Membuat kontrol tab dengan tab bulat dalam gaya Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Membuat kontrol tab dengan tab bulat dan tombol gulir dengan gaya Microsoft Visual Studio 2005.

Tabel berikut mencantumkan nilai yang bisa Anda tentukan location untuk parameter .

Location Deskripsi
LOCATION_BOTTOM Tab terletak di bagian bawah kontrol tab.
LOCATION_TOP Tab terletak di bagian atas kontrol tab.

Contoh

Contoh berikut menunjukkan cara menggunakan Create metode di CMFCTabCtrl kelas . Contoh ini adalah bagian dari sampel Kumpulan Status.

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

Mengempis ukuran area tab yang ditentukan.

virtual void CalcRectEdit(CRect& rectEdit);

Parameter

rectEdit
[di] Persegi panjang yang menentukan area tab.

Keterangan

Metode ini dipanggil saat Anda mengubah label tab. Metode ini mengempiskan sisi kiri dan kanan persegi panjang yang ditentukan sebesar satu setengah tinggi tab saat ini, dan mengempis bagian atas dan bawah satu unit.

CMFCTabCtrl::EnableActiveTabCloseButton

Memperlihatkan atau menyembunyikan tombol Tutup ( X) pada tab aktif.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk menampilkan tombol Tutup pada tab aktif; FALSE untuk menampilkan tombol Tutup di sudut kanan atas area tab. Nilai defaultnya adalah TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Mengaktifkan atau menonaktifkan label tab yang dapat diedit.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parameter

bEnable
[di] TRUE untuk mengaktifkan label tab yang dapat diedit; FALSE untuk menonaktifkan label tab yang dapat diedit.

Keterangan

CMFCTabCtrl::EnableTabDocumentsMenu

Beralih antara antarmuka pengguna yang menggunakan dua tombol untuk menggulir tab jendela dan antarmuka yang menampilkan menu pop-up jendela bertab.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk menampilkan menu pop-up label jendela bertab; FALSE untuk menampilkan tombol gulir maju dan mundur. Nilai defaultnya adalah TRUE.

Keterangan

Saat pengguna mengklik label tab, kerangka kerja menampilkan jendela bertab yang sesuai. Jika label tab terlihat, jendela bertab dibuka tanpa mengubah posisinya. Jika pengguna memilih dokumen dari menu pop-up dan jendela bertab terkait mati, jendela bertab menjadi tab pertama.

CMFCTabCtrl::EnsureVisible

Memastikan bahwa tab terlihat.

virtual BOOL EnsureVisible(int iTab);

Parameter

iTab
[di] Indeks berbasis nol tab.

Tampilkan Nilai

TRUE jika berhasil; FALSE iTab jika indeks parameter tidak valid.

Keterangan

Gunakan metode ini untuk menjamin bahwa tab yang ditentukan terlihat. Kontrol tab akan menggulir jika diperlukan.

CMFCTabCtrl::GetDocumentIcon

Mengambil gambar yang terkait dengan tab di menu pop-up jendela bertab.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parameter

nCmdID
[di] ID perintah tab di menu pop-up jendela bertab.

Tampilkan Nilai

Handel gambar bitmap.

CMFCTabCtrl::GetFirstVisibleTabNum

Mengambil indeks tab pertama yang terlihat di kontrol tab saat ini.

virtual int GetFirstVisibleTabNum() const;

Tampilkan Nilai

Indeks berbasis nol tab di kontrol tab.

Keterangan

Gunakan metode ini hanya ketika kontrol tab ditampilkan dalam gaya Microsoft OneNote. CMFCTabCtrl::IsOneNoteStyle Gunakan metode untuk menentukan gaya.

CMFCTabCtrl::GetResizeMode

Mengambil nilai yang menentukan bagaimana kontrol tab saat ini dapat diubah ukurannya.

ResizeMode GetResizeMode() const;

Tampilkan Nilai

Salah CMFCTabCtrl::ResizeMode satu nilai enumerasi yang menentukan bagaimana kontrol tab dapat diubah ukurannya. Untuk daftar nilai yang mungkin, lihat bagian Keterangan dari CMFCTabCtrl::SetResizeMode metode .

CMFCTabCtrl::GetScrollBar

Mengambil penunjuk ke objek bilah gulir yang terkait dengan kontrol tab.

CScrollBar* GetScrollBar();

Tampilkan Nilai

Penunjuk ke objek bilah gulir, atau NULL jika kontrol tab tidak dibuat dengan menggunakan STYLE_FLAT_SHARED_HORZ_SCROLL gaya .

Keterangan

Gunakan metode ini untuk mengakses bilah gulir tersemat kontrol tab. Objek bilah gulir dibuat hanya ketika kontrol tab memiliki STYLE_FLAT_SHARED_HORZ_SCROLL gaya.

CMFCTabCtrl::GetTabArea

Mengambil persegi panjang pembatas area label tab di bagian atas atau bawah kontrol tab.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parameter

rectTabAreaTop
[out] Ketika metode ini kembali, referensi ini berisi persegi panjang yang mengikat area label tab atas. Persegi panjang berada dalam koordinat klien. Referensi ini kosong jika tidak ada area label tab yang ada di bagian atas kontrol tab.

rectTabAreaBottom
[out] Ketika metode ini kembali, referensi ini berisi persegi panjang yang mengikat area label tab bawah. Persegi panjang berada dalam koordinat klien. Referensi ini kosong jika tidak ada area label tab di bagian bawah kontrol tab.

Keterangan

Gunakan metode ini untuk menentukan ukuran dan posisi area tab di jendela bertab.

CMFCTabCtrl::GetTabMaxWidth

Mengambil lebar maksimum tab.

int GetTabMaxWidth() const;

Tampilkan Nilai

Lebar maksimum tab, dalam piksel. Jika nilai yang dikembalikan adalah 0, lebar tab tidak terbatas.

Keterangan

Gunakan metode CMFCTabCtrl::SetTabMaxWidth untuk mengatur lebar tab maksimum.

CMFCTabCtrl::GetTabsHeight

Mengambil tinggi area tab kontrol tab saat ini.

virtual int GetTabsHeight() const;

Tampilkan Nilai

Tinggi area tab jika ada tab yang terlihat, atau nol jika tidak ada tab yang terlihat.

CMFCTabCtrl::GetTabsRect

Mengambil persegi panjang yang mengikat area tab kontrol tab saat ini.

virtual void GetTabsRect(CRect& rect) const;

Parameter

rect
[out] Ketika metode ini kembali, rect parameter berisi persegi panjang yang mengikat area tab.

CMFCTabCtrl::GetWndArea

Mengambil batas area klien dari kontrol tab saat ini.

void GetWndArea(CRect& rect) const;

Parameter

rect
[masuk, keluar] Ketika metode ini kembali, parameter ini berisi persegi panjang yang mengikat kontrol tab saat ini.

Keterangan

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Menyembunyikan bilah gulir horizontal, jika ada, di jendela aktif.

void HideActiveWindowHorzScrollBar();

Keterangan

Gunakan metode ini untuk mencegah kontrol tab berkedip saat pengguna beralih di antara halaman kontrol tab.

CMFCTabCtrl::HideInactiveWindow

Menentukan apakah kerangka kerja menampilkan jendela kontrol tab tidak aktif.

void HideInactiveWindow(BOOL bHide = TRUE);

Parameter

bHide
[di] TRUE tidak menampilkan jendela yang tidak aktif; FALSE untuk menampilkan jendela yang tidak aktif. Nilai defaultnya adalah TRUE.

Keterangan

CMFCTabCtrl::HideNoTabs

Mengaktifkan atau menonaktifkan gambar area tab jika tidak ada tab yang terlihat.

void HideNoTabs(BOOL bHide=TRUE);

Parameter

bHide
[di] TRUE untuk mengaktifkan menggambar area tab; FALSE untuk menonaktifkan gambar. Nilai defaultnya adalah TRUE.

Keterangan

CMFCTabCtrl::HideSingleTab

Mengaktifkan atau menonaktifkan gambar tab jika ada satu jendela bertab.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parameter

bHide
[di] TRUE untuk tidak menggambar tab untuk satu jendela bertab; FALSE untuk menggambar satu tab. Nilai defaultnya adalah TRUE.

Keterangan

CMFCTabCtrl::IsActiveInMDITabGroup

Menunjukkan apakah tab kontrol tab saat ini adalah tab aktif dalam grup tab antarmuka beberapa dokumen.

BOOL IsActiveInMDITabGroup() const;

Tampilkan Nilai

TRUE jika tab kontrol tab saat ini adalah tab aktif dalam grup tab MDI; jika tidak, FALSE.

Keterangan

Anda dapat menata beberapa jendela dokumen ke dalam grup tab vertikal atau horizontal dan mengacak dokumen dengan mudah dari satu grup tab ke grup tab lainnya.

CMFCTabCtrl::IsActiveTabBoldFont

Menunjukkan apakah teks tab aktif ditampilkan menggunakan font tebal.

BOOL IsActiveTabBoldFont() const;

Tampilkan Nilai

TRUE jika tab aktif ditampilkan menggunakan font tebal; jika tidak, FALSE.

Keterangan

CMFCTabCtrl::SetActiveTabBoldFont Gunakan metode untuk mengubah font tab aktif.

CMFCTabCtrl::IsActiveTabCloseButton

Menunjukkan apakah tombol Tutup ( X) ditampilkan pada tab aktif atau di sudut kanan atas area tab.

virtual BOOL IsActiveTabCloseButton() const;

Tampilkan Nilai

TRUE jika tombol Tutup ditampilkan pada tab aktif; FALSE jika tombol Tutup ditampilkan di sudut kanan atas area tab.

Keterangan

CMFCTabCtrl::IsDrawFrame

Menunjukkan apakah jendela bertab menggambar persegi panjang bingkai di sekitar panel yang disematkan.

BOOL IsDrawFrame() const;

Tampilkan Nilai

TRUE jika persegi panjang bingkai digambar; jika tidak, FALSE.

Keterangan

CMFCTabCtrl::SetDrawFrame Gunakan metode untuk mengaktifkan atau menonaktifkan menggambar persegi panjang bingkai.

CMFCTabCtrl::IsFlatFrame

Menunjukkan apakah bingkai di sekitar area tab datar atau 3D.

BOOL IsFlatFrame() const;

Tampilkan Nilai

TRUE jika bingkai di sekitar area tab datar; FALSE jika bingkai adalah tiga dimensi.

Keterangan

CMFCTabCtrl::SetFlatFrame Gunakan metode untuk mengubah bagaimana bingkai digambar.

CMFCTabCtrl::IsFlatTab

Menunjukkan apakah tampilan tab di kontrol tab saat ini datar atau tidak.

virtual BOOL IsFlatTab() const;

Tampilkan Nilai

TRUE jika tampilan tab di kontrol tab saat ini datar; jika tidak, FALSE.

CMFCTabCtrl::IsLeftRightRounded

Menunjukkan apakah tampilan sisi kiri dan kanan tab di kontrol tab saat ini dibulatkan.

virtual BOOL IsLeftRightRounded() const;

Tampilkan Nilai

TRUE jika sisi setiap tab dibulatkan; jika tidak, FALSE.

CMFCTabCtrl::IsMDITabGroup

Menunjukkan apakah kontrol tab saat ini terkandung di area klien dari jendela antarmuka beberapa dokumen.

virtual BOOL IsMDITabGroup() const;

Tampilkan Nilai

TRUE jika kontrol tab saat ini berada di jendela area klien MDI; jika tidak, FALSE.

CMFCTabCtrl::IsOneNoteStyle

Menunjukkan apakah kontrol tab saat ini ditampilkan dalam gaya Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Tampilkan Nilai

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

CMFCTabCtrl::IsSharedScroll

Menunjukkan apakah kontrol tab saat ini memiliki bilah gulir yang dapat menggulir tabnya sebagai grup.

BOOL IsSharedScroll() const;

Tampilkan Nilai

TRUE jika kontrol tab memiliki bilah gulir bersama; jika tidak, FALSE.

Keterangan

Metode ini mengembalikan TRUE jika style parameter CMFCTabCtrl::Create metode adalah STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::IsTabDocumentsMenu

Menunjukkan apakah kontrol tab menampilkan tombol gulir atau tombol yang menampilkan menu jendela bertab.

BOOL IsTabDocumentsMenu() const;

Tampilkan Nilai

TRUE jika jendela bertab digulir menggunakan menu popup label jendela bertab; FALSE jika jendela bertab digulir menggunakan tombol gulir maju dan mundur.

Keterangan

CMFCTabCtrl::EnableTabDocumentsMenu Gunakan metode untuk menentukan metode menggulir jendela bertab.

CMFCTabCtrl::IsVS2005Style

Menunjukkan apakah tab digambar menggunakan gaya Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Tampilkan Nilai

TRUE jika tab digambar menggunakan gaya Visual Studio 2005; jika tidak, FALSE.

Keterangan

style Gunakan parameter CMFCTabCtrl::Create metode untuk menentukan bagaimana tab digambar.

CMFCTabCtrl::m_bEnableActivate

Mencegah tampilan aktif kehilangan fokus saat tab baru disisipkan dan diaktifkan.

static BOOL m_bEnableActivate;

Keterangan

Fokus biasanya diambil oleh jendela bertab baru saat tab disisipkan dan dibuat aktif. Atur CMFCTabCtrl::m_bEnableActivate variabel anggota ke FALSE untuk mempertahankan fokus asli. Nilai defaultnya adalah TRUE.

CMFCTabCtrl::ModifyTabStyle

Menentukan tampilan tab di kontrol tab saat ini.

BOOL ModifyTabStyle(Style style);

Parameter

style
[di] Salah satu nilai enumerasi yang menentukan tampilan kontrol tab. Untuk informasi selengkapnya, lihat tabel di Keterangan.

Tampilkan Nilai

Selalu TRUE.

Keterangan

Nilai style parameter dapat menjadi salah satu enumerasi berikut CMFCTabCtrl::Style .

Nama Deskripsi
STYLE_3D Menampilkan tab tiga dimensi persegi panjang yang memiliki sudut bulat.
STYLE_3D_ONENOTE Menampilkan tab tiga dimensi yang memiliki satu sisi vertikal dan satu sisi miring dan yang memiliki sudut bulat.
STYLE_3D_ROUNDED Menampilkan tab tiga dimensi yang memiliki sisi miring dan sudut bulat.
STYLE_3D_ROUNDED_SCROLL Menampilkan tab tiga dimensi yang memiliki sisi miring dan sudut bulat. Jika ada lebih banyak tab daripada yang dapat ditampilkan pada saat yang sama, kerangka kerja menampilkan panah drop-down dan menu tab untuk aktif.
STYLE_3D_SCROLLED Menampilkan tab tiga dimensi persegi panjang. Jika ada lebih banyak tab daripada yang dapat ditampilkan pada saat yang sama, kerangka kerja menampilkan panah drop-down dan menu tab untuk aktif.
STYLE_3D_VS2005 Menampilkan tab tiga dimensi dan bulat yang memiliki satu sisi miring dan satu sisi vertikal.
STYLE_FLAT Menampilkan tab dua dimensi yang memiliki sisi kiri dan kanan miring.
STYLE_FLAT_SHARED_HORZ_SCROLL Menampilkan tab dua dimensi. Jika ada lebih banyak tab daripada yang dapat ditampilkan pada saat yang sama, kerangka kerja menampilkan panah gulir di akhir area tab.

CMFCTabCtrl::OnDragEnter

Dipanggil oleh kerangka kerja selama operasi seret dan letakkan saat kursor pertama kali memasuki jendela kontrol tab saat ini.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parameter

pDataObject
[di] Menunjuk ke objek data yang berisi data yang diseret pengguna.

dwKeyState
[di] Berisi status kunci pengubah. Parameter ini adalah kombinasi bitwise "atau" (|) dari nilai berikut: MK_CONTROL, , MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTONdan MK_RBUTTON. Untuk informasi selengkapnya, lihat bagian Parameter Pesan dari Tentang Input Mouse.

point
[di] Berisi lokasi kursor saat ini dalam koordinat klien.

Tampilkan Nilai

Selalu DROPEFFECT_NONE, yang berarti bahwa target penghilangan tidak dapat menerima data.

Keterangan

Gunakan metode ini untuk mendukung operasi seret dan letakkan. Ambil alih metode ini untuk mengimplementasikan perilaku kustom Anda sendiri.

Secara default, metode ini hanya memanggil CMFCTabCtrl::OnDragOver, yang selalu mengembalikan DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

Dipanggil oleh kerangka kerja selama operasi seret saat mouse dipindahkan ke jendela target drop.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parameter

pDataObject
[di] Penunjuk ke COleDataObject objek yang sedang diseret ke atas target drop.

dwKeyState
[di] Status kunci pengubah, yang merupakan kombinasi bitwise "atau" (|) dari MK_CONTROL, , MK_SHIFT, MK_ALTMK_LBUTTON, , MK_MBUTTONdan MK_RBUTTON. Untuk informasi selengkapnya, lihat "Parameter Pesan" di Tentang Input Mouse.

point
[di] Posisi mouse saat ini.

Tampilkan Nilai

Selalu DROPEFFECT_NONE.

Keterangan

Ambil alih metode ini dengan implementasi kustom Anda. Untuk informasi lebih lanjut, lihat metode CView::OnDragOver.

CMFCTabCtrl::OnShowTabDocumentsMenu

Menampilkan menu pop-up jendela bertab, menunggu hingga pengguna memilih tab, dan menjadikan tab yang dipilih sebagai tab aktif.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parameter

point
[di] Koordinat tempat menampilkan menu pop-up.

Keterangan

CMFCTabCtrl::SetActiveInMDITabGroup

Mengatur tab saat ini dari kontrol tab sebagai tab aktif dalam grup tab antarmuka beberapa dokumen.

void SetActiveInMDITabGroup(BOOL bActive);

Parameter

bActive
[di] TRUE untuk membuat tab saat ini menjadi tab aktif; FALSE untuk membuat tab saat ini tidak aktif.

Keterangan

Anda dapat menata beberapa jendela dokumen ke dalam grup tab vertikal atau horizontal dan mengacak dokumen dengan mudah dari satu grup tab ke grup tab lainnya.

CMFCTabCtrl::SetActiveTab

Mengaktifkan tab.

virtual BOOL SetActiveTab(int iTab);

Parameter

iTab
[di] Menentukan indeks berbasis nol tab untuk diaktifkan.

Tampilkan Nilai

TRUE jika tab yang ditentukan dibuat aktif; FALSE jika nilai parameter yang ditentukan iTab tidak valid.

Keterangan

Ini mengirimkan AFX_WM_CHANGE_ACTIVE_TAB pemberitahuan ke jendela induk dan bingkai induk kontrol tab.

Metode ini SetActiveTab secara otomatis memanggil CMFCTabCtrl::HideActiveWindowHorzScrollBar metode untuk mencegah layar berkedip.

CMFCTabCtrl::SetActiveTabBoldFont

Mengaktifkan atau menonaktifkan penggunaan font tebal pada tab aktif.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parameter

bIsBold
[di] TRUE untuk menggunakan font tebal untuk menampilkan label tab aktif; FALSE untuk menggunakan font standar untuk menampilkan label. Nilai defaultnya adalah TRUE.

Keterangan

CMFCTabCtrl::SetDrawFrame

Menentukan apakah persegi panjang bingkai digambar di sekitar bilah yang disematkan.

void SetDrawFrame(BOOL bDraw=TRUE);

Parameter

bDraw
[di] TRUE untuk menampilkan persegi panjang bingkai di sekitar bilah yang disematkan; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Keterangan

CMFCTabCtrl::SetFlatFrame

Menentukan apakah akan menggambar bingkai datar atau 3D di sekitar area tab.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Parameter

bFlat
[di] TRUE untuk menggambar bingkai datar (2D) di sekitar area tab; FALSE untuk menggambar bingkai tiga dimensi (3D). Nilai defaultnya adalah TRUE.

bRepaint
[di] TRUE untuk segera menggambar ulang jendela; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Keterangan

CMFCTabCtrl::SetImageList

Menentukan daftar gambar.

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 yang berisi daftar gambar.

cx
[di] Lebar setiap gambar, dalam piksel. Nilai default-nya adalah 15.

clrTransp
[di] Warna gambar transparan. Bagian gambar yang berwarna ini akan transparan. Nilai defaultnya adalah magenta warna, RGB(255,0,255).

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

Tampilkan Nilai

TRUE jika metode ini berhasil. FALSE jika kontrol tab dibuat dengan menggunakan gaya datar atau jika metode pertama kelebihan beban tidak dapat memuat bitmap yang ditentukan oleh uiID parameter.

Keterangan

Gunakan metode ini untuk mengatur daftar gambar untuk kontrol tab. Gambar dari daftar gambar ditampilkan di samping label tab. Metode ini menghitung ulang tinggi tab sehingga tab berukuran besar untuk berisi gambar dan teks.

CMFCBaseTabCtrl::AddTab Gunakan metode yang diwariskan oleh kontrol tab untuk menentukan indeks gambar yang akan ditampilkan.

CMFCTabCtrl::SetResizeMode

Menentukan bagaimana kontrol tab saat ini dapat diubah ukurannya lalu memutar ulang kontrol.

void SetResizeMode(ResizeMode resizeMode);

Parameter

resizeMode
[di] Salah CMFCTabCtrl::ResizeMode satu nilai enumerasi yang menentukan bagaimana kontrol tab dapat diubah ukurannya. Untuk daftar nilai yang mungkin, lihat tabel di Keterangan.

Keterangan

Parameter resizeMode dapat menjadi salah satu nilai enumerasi berikut ResizeMode .

Nama Deskripsi
RESIZE_NO Kontrol tab tidak dapat diubah ukurannya.
RESIZE_VERT Kontrol tab dapat diubah ukurannya secara vertikal tetapi tidak secara horizontal.
RESIZE_HORIZ Kontrol tab dapat diubah ukurannya secara horizontal tetapi tidak secara vertikal.

CMFCTabCtrl::SetTabMaxWidth

Menentukan lebar tab maksimum dalam jendela bertab.

void SetTabMaxWidth(int nTabMaxWidth);

Parameter

nTabMaxWidth
[di] Lebar tab maksimum, dalam piksel.

Keterangan

Gunakan metode ini untuk membatasi lebar setiap tab dalam jendela bertab. Metode ini berguna jika tab memiliki label yang sangat panjang. CMFCTabCtrl Konstruktor kelas menginisialisasi lebar tab maksimum ke 0, yang sebenarnya berarti bahwa lebar tidak terbatas.

CMFCTabCtrl::StopResize

Mengakhiri operasi mengubah ukuran saat ini pada kontrol tab.

void StopResize(BOOL bCancel);

Parameter

bCancel
[di] TRUE untuk meninggalkan operasi mengubah ukuran saat ini; FALSE untuk menyelesaikan operasi mengubah ukuran saat ini. Dalam kedua kasus, kerangka kerja berhenti menggambar persegi panjang mengubah ukuran.

CMFCTabCtrl::SynchronizeScrollBar

Menggambar bilah gulir horizontal pada kontrol tab yang menampilkan tab datar.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parameter

pScrollInfo
[out] Penunjuk SCROLLINFO ke struktur atau NULL. Ketika metode ini kembali, dan jika parameter ini tidak NULL, struktur berisi semua parameter bilah gulir. Nilai defaultnya adalah NULL.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Metode ini hanya memengaruhi kontrol tab yang menampilkan tab datar. Bilah gulir memengaruhi semua tab secara bersamaan.

Lihat juga

Bagan Hierarki
Kelas
CDockablePane Kelas
CMFCBaseTabCtrl Kelas