CTabCtrl Kelas

Menyediakan fungsionalitas kontrol tab umum Windows.

Sintaks

class CTabCtrl : public CWnd

Anggota

Konstruktor Publik

Nama	Deskripsi
CTabCtrl::CTabCtrl	Membuat CTabCtrl objek.

Metode Publik

Nama	Deskripsi
CTabCtrl::AdjustRect	Menghitung area tampilan kontrol tab yang diberi persegi panjang jendela, atau menghitung persegi panjang jendela yang sesuai dengan area tampilan tertentu.
CTabCtrl::Create	Membuat kontrol tab dan melampirkannya ke instans TabCtrl objek
CTabCtrl::CreateEx	Membuat kontrol tab dengan gaya perluasan Windows yang ditentukan dan melampirkannya ke instans CTabCtrl objek.
CTabCtrl::DeleteAllItems	Menghapus semua item dari kontrol tab.
CTabCtrl::DeleteItem	Menghapus item dari kontrol tab.
CTabCtrl::DeselectAll	Mereset item dalam kontrol tab, menghapus item yang ditekan.
CTabCtrl::DrawItem	Menggambar item tertentu dari kontrol tab.
CTabCtrl::GetCurFocus	Mengambil tab dengan fokus kontrol tab saat ini.
CTabCtrl::GetCurSel	Menentukan tab yang saat ini dipilih dalam kontrol tab.
CTabCtrl::GetExtendedStyle	Mengambil gaya yang diperluas yang saat ini digunakan untuk kontrol tab.
CTabCtrl::GetImageList	Mengambil daftar gambar yang terkait dengan kontrol tab.
CTabCtrl::GetItem	Mengambil informasi tentang tab dalam kontrol tab.
CTabCtrl::GetItemCount	Mengambil jumlah tab dalam kontrol tab.
CTabCtrl::GetItemRect	Mengambil persegi panjang pembatas untuk tab dalam kontrol tab.
CTabCtrl::GetItemState	Mengambil status item kontrol tab yang ditunjukkan.
CTabCtrl::GetRowCount	Mengambil jumlah baris tab saat ini dalam kontrol tab.
CTabCtrl::GetToolTips	Mengambil handel kontrol tips alat yang terkait dengan kontrol tab.
CTabCtrl::HighlightItem	Mengatur status sorotan item tab.
CTabCtrl::HitTest	Menentukan tab mana, jika ada, berada pada posisi layar tertentu.
CTabCtrl::InsertItem	Menyisipkan tab baru dalam kontrol tab.
CTabCtrl::RemoveImage	Menghapus gambar dari daftar gambar kontrol tab.
CTabCtrl::SetCurFocus	Mengatur fokus ke tab tertentu dalam kontrol tab.
CTabCtrl::SetCurSel	Memilih tab dalam kontrol tab.
CTabCtrl::SetExtendedStyle	Mengatur gaya yang diperluas untuk kontrol tab.
CTabCtrl::SetImageList	Menetapkan daftar gambar ke kontrol tab.
CTabCtrl::SetItem	Mengatur beberapa atau semua atribut tab.
CTabCtrl::SetItemExtra	Mengatur jumlah byte per tab yang dicadangkan untuk data yang ditentukan aplikasi dalam kontrol tab.
CTabCtrl::SetItemSize	Mengatur lebar dan tinggi item.
CTabCtrl::SetItemState	Mengatur status item kontrol tab yang ditunjukkan.
CTabCtrl::SetMinTabWidth	Mengatur lebar minimum item dalam kontrol tab.
CTabCtrl::SetPadding	Mengatur jumlah ruang (padding) di sekitar setiap ikon tab dan label dalam kontrol tab.
CTabCtrl::SetToolTips	Menetapkan kontrol tips alat ke kontrol tab.

Keterangan

"Kontrol tab" dianalogikan dengan pembagi dalam buku catatan atau label dalam kabinet file. Dengan menggunakan kontrol tab, aplikasi dapat menentukan beberapa halaman untuk area yang sama dari jendela atau kotak dialog. Setiap halaman terdiri dari sekumpulan informasi atau sekelompok kontrol yang ditampilkan aplikasi saat pengguna memilih tab yang sesuai. Jenis khusus kontrol tab menampilkan tab yang terlihat seperti tombol. Mengklik tombol harus segera melakukan perintah alih-alih menampilkan halaman.

Kontrol ini (dan oleh karena itu CTabCtrl kelas) hanya tersedia untuk program yang berjalan di bawah Windows 95/98 dan Windows NT versi 3.51 dan yang lebih baru.

Untuk informasi selengkapnya tentang CTabCtrl, lihat Kontrol dan Menggunakan CTabCtrl.

Hierarki Warisan

CObject
CCmdTarget
CWnd

CTabCtrl

Persyaratan

Header: afxcmn.h

CTabCtrl::AdjustRect

Menghitung area tampilan kontrol tab yang diberi persegi panjang jendela, atau menghitung persegi panjang jendela yang sesuai dengan area tampilan tertentu.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parameter

bLarger
Menunjukkan operasi mana yang harus dilakukan. Jika parameter ini adalah TRUE, lpRect menentukan persegi panjang tampilan dan menerima persegi panjang jendela yang sesuai. Jika parameter ini adalah FALSE, lpRect menentukan persegi panjang jendela dan menerima persegi panjang tampilan yang sesuai.

lpRect
Penunjuk ke RECT struktur yang menentukan persegi panjang yang diberikan dan menerima persegi panjang terhitung.

Contoh

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

Membuat kontrol tab dan melampirkannya ke instans CTabCtrl objek.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Menentukan gaya kontrol tab. Terapkan kombinasi gaya kontrol tab apa pun, yang dijelaskan dalam Windows SDK. Lihat Keterangan untuk daftar gaya jendela yang juga bisa Anda terapkan ke kontrol.

rect
Menentukan ukuran dan posisi kontrol tab. Ini bisa berupa CRect objek atau RECT struktur.

pParentWnd
Menentukan jendela induk kontrol tab, biasanya .CDialog Ini tidak boleh NULL.

nID
Menentukan ID kontrol tab.

Tampilkan Nilai

TRUE jika inisialisasi objek berhasil; jika tidak FALSE.

Keterangan

Anda membuat CTabCtrl objek dalam dua langkah. Pertama, panggil konstruktor, lalu panggil Create, yang membuat kontrol tab dan melampirkannya ke CTabCtrl objek.

Selain gaya kontrol tab, Anda bisa menerapkan gaya jendela berikut ke kontrol tab:

• WS_CHILD: Membuat jendela anak yang mewakili kontrol tab. Tidak dapat digunakan dengan gaya WS_POPUP.
• WS_VISIBLE: Membuat kontrol tab yang awalnya terlihat.
• WS_DISABLED: Membuat jendela yang awalnya dinonaktifkan.
• WS_GROUP: Menentukan kontrol pertama grup kontrol tempat pengguna dapat berpindah dari satu kontrol ke kontrol berikutnya dengan tombol panah. Semua kontrol yang ditentukan dengan WS_GROUPgaya : setelah kontrol pertama milik grup yang sama. Kontrol berikutnya dengan WS_GROUPgaya : mengakhiri grup gaya dan memulai grup berikutnya (yaitu, satu grup berakhir di mana grup berikutnya dimulai).
• WS_TABSTOP: Menentukan salah satu dari sejumlah kontrol yang dapat dipindahkan pengguna dengan menggunakan kunci TAB. Tombol TAB memindahkan pengguna ke kontrol berikutnya yang ditentukan oleh WS_TABSTOPgaya : .

Untuk membuat kontrol tab dengan gaya jendela yang diperluas, panggil CTabCtrl::CreateEx alih-alih Create.

Contoh

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

CTabCtrl::CreateEx

Membuat kontrol (jendela anak) dan mengaitkannya dengan CTabCtrl objek.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Menentukan gaya kontrol yang diperluas yang sedang dibuat. Untuk daftar gaya Windows yang diperluas, lihat dwExStyle parameter untuk CreateWindowEx di Windows SDK.

dwStyle
Menentukan gaya kontrol tab. Terapkan kombinasi gaya kontrol tab apa pun, yang dijelaskan dalam Windows SDK. Lihat Komentar di Create untuk daftar gaya jendela yang juga bisa Anda terapkan ke kontrol.

rect
Referensi ke struktur yang RECT menjelaskan ukuran dan posisi jendela yang akan dibuat, dalam koordinat klien .pParentWnd

pParentWnd
Penunjuk ke jendela yang merupakan induk kontrol.

nID
ID jendela anak kontrol.

Tampilkan Nilai

Bukan nol jika berhasil jika tidak 0.

Keterangan

Gunakan CreateEx alih-alih Create untuk menerapkan gaya Windows yang diperluas, yang ditentukan oleh preface WS_EX_gaya windows yang diperluas .

CreateEx membuat kontrol dengan gaya Windows yang diperluas yang ditentukan oleh dwExStyle. Atur gaya yang diperluas khusus untuk kontrol menggunakan SetExtendedStyle. Misalnya, gunakan CreateEx untuk mengatur gaya seperti WS_EX_CONTEXTHELP, tetapi gunakan SetExtendedStyle untuk mengatur gaya seperti TCS_EX_FLATSEPARATORS. Untuk informasi selengkapnya, lihat gaya yang dijelaskan dalam Kontrol Tab Gaya yang Diperluas di Windows SDK.

CTabCtrl::CTabCtrl

Membuat CTabCtrl objek.

CTabCtrl();

CTabCtrl::DeleteAllItems

Menghapus semua item dari kontrol tab.

BOOL DeleteAllItems();

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

CTabCtrl::DeleteItem

Menghapus item yang ditentukan dari kontrol tab.

BOOL DeleteItem(int nItem);

Parameter

nItem
Nilai berbasis nol dari item yang akan dihapus.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Contoh

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Mereset item dalam kontrol tab, menghapus item yang ditekan.

void DeselectAll(BOOL fExcludeFocus);

Parameter

fExcludeFocus
Bendera yang menentukan cakupan penghapusan item. Jika parameter ini diatur ke FALSE, semua tombol tab akan diatur ulang. Jika diatur ke TRUE, maka semua item tab kecuali item yang saat ini dipilih akan diatur ulang.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan Win32, , TCM_DESELECTALLseperti yang dijelaskan dalam Windows SDK.

CTabCtrl::DrawItem

Dipanggil oleh kerangka kerja saat aspek visual kontrol tab gambar pemilik berubah.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parameter

lpDrawItemStruct
Penunjuk ke struktur yang DRAWITEMSTRUCT menjelaskan item yang akan dicat.

Keterangan

Anggota itemAction DRAWITEMSTRUCT struktur mendefinisikan tindakan menggambar yang harus dilakukan.

Secara default, fungsi anggota ini tidak melakukan apa pun. Ambil alih fungsi anggota ini untuk mengimplementasikan gambar untuk objek gambar CTabCtrl pemilik.

Aplikasi harus memulihkan semua objek antarmuka perangkat grafis (GDI) yang dipilih untuk konteks tampilan yang disediakan sebelum lpDrawItemStruct fungsi anggota ini berakhir.

CTabCtrl::GetCurFocus

Mengambil indeks tab dengan fokus saat ini.

int GetCurFocus() const;

Tampilkan Nilai

Indeks berbasis nol tab dengan fokus saat ini.

CTabCtrl::GetCurSel

Mengambil tab yang saat ini dipilih dalam kontrol tab.

int GetCurSel() const;

Tampilkan Nilai

Indeks berbasis nol dari tab yang dipilih jika berhasil atau -1 jika tidak ada tab yang dipilih.

CTabCtrl::GetExtendedStyle

Mengambil gaya yang diperluas yang saat ini digunakan untuk kontrol tab.

DWORD GetExtendedStyle();

Tampilkan Nilai

Mewakili gaya yang diperluas yang saat ini digunakan untuk kontrol tab. Nilai ini adalah kombinasi gaya yang diperluas kontrol tab, seperti yang dijelaskan dalam Windows SDK.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TCM_GETEXTENDEDSTYLEWin32 , seperti yang dijelaskan dalam Windows SDK.

CTabCtrl::GetImageList

Mengambil daftar gambar yang terkait dengan kontrol tab.

CImageList* GetImageList() const;

Tampilkan Nilai

Jika berhasil, penunjuk ke daftar gambar kontrol tab; jika tidak, NULL.

CTabCtrl::GetItem

Mengambil informasi tentang tab dalam kontrol tab.

BOOL GetItem(int nItem,   TCITEM* pTabCtrlItem) const;

Parameter

nItem
Indeks berbasis nol tab.

pTabCtrlItem
Penunjuk TCITEM ke struktur, digunakan untuk menentukan informasi yang akan diambil. Juga digunakan untuk menerima informasi tentang tab. Struktur ini digunakan dengan InsertItemfungsi anggota , , GetItemdan SetItem .

Tampilkan Nilai

Mengembalikan TRUE jika berhasil; FALSE jika tidak.

Keterangan

Saat pesan dikirim, mask anggota menentukan atribut mana yang akan dikembalikan. mask Jika anggota menentukan TCIF_TEXT nilai, pszText anggota harus berisi alamat buffer yang menerima teks item dan cchTextMax anggota harus menentukan ukuran buffer.

• mask

  Nilai yang menentukan anggota struktur mana yang TCITEM akan diambil atau diatur. Anggota ini bisa nol atau kombinasi dari nilai berikut:

  • TCIF_TEXT: Anggota pszText valid.
  • TCIF_IMAGE: Anggota iImage valid.
  • TCIF_PARAM: Anggota lParam valid.
  • TCIF_RTLREADING: Teks pszText ditampilkan menggunakan urutan baca kanan-ke-kiri pada sistem Ibrani atau Arab.
  • TCIF_STATE: Anggota dwState valid.

• pszText

  Penunjuk ke string null-terminated yang berisi teks tab jika struktur berisi informasi tentang tab. Jika struktur menerima informasi, anggota ini menentukan alamat buffer yang menerima teks tab.

• cchTextMax

  Ukuran buffer yang diacu oleh pszText. Anggota ini diabaikan jika struktur tidak menerima informasi.

• iImage Indeks ke dalam daftar gambar kontrol tab, atau -1 jika tidak ada gambar untuk tab.

• lParam

  Data yang ditentukan aplikasi yang terkait dengan tab. Jika ada lebih dari 4 byte data yang ditentukan aplikasi per tab, aplikasi harus menentukan struktur dan menggunakannya alih-alih TCITEM struktur. Anggota pertama dari struktur yang ditentukan aplikasi harus berupa TCITEMHEADERstruktur. Strukturnya TCITEMHEADER identik dengan TCITEM struktur, tetapi tanpa lParam anggota. Perbedaan antara ukuran struktur Anda dan ukuran TCITEMHEADER struktur harus sama dengan jumlah byte tambahan per tab.

Contoh

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}

CTabCtrl::GetItemCount

Mengambil jumlah tab dalam kontrol tab.

int GetItemCount() const;

Tampilkan Nilai

Jumlah item dalam kontrol tab.

Contoh

Lihat contoh untuk CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Mengambil persegi panjang pembatas untuk tab yang ditentukan dalam kontrol tab.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parameter

nItem
Indeks berbasis nol dari item tab.

lpRect
Penunjuk ke RECT struktur yang menerima persegi panjang pembatas tab. Koordinat ini menggunakan mode pemetaan viewport saat ini.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Contoh

Lihat contoh untuk CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Mengambil status item kontrol tab yang diidentifikasi oleh nItem.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parameter

nItem
Nomor indeks berbasis nol dari item untuk mengambil informasi status.

dwMask
Masker menentukan bendera status item mana yang akan dikembalikan. Untuk daftar nilai, lihat anggota TCITEM mask struktur, seperti yang dijelaskan di Windows SDK.

Tampilkan Nilai

Referensi ke nilai DWORD yang menerima informasi status. Dapat berupa salah satu dari nilai berikut:

Nilai	Deskripsi
TCIS_BUTTONPRESSED	Item kontrol tab dipilih.
TCIS_HIGHLIGHTED	Item kontrol tab disorot, dan tab dan teks digambar menggunakan warna sorotan saat ini. Saat menggunakan warna sorotan, ini akan menjadi interpolasi sejati, bukan warna terlarut.

Keterangan

Status item ditentukan oleh dwState anggota TCITEM struktur.

CTabCtrl::GetRowCount

Mengambil jumlah baris saat ini dalam kontrol tab.

int GetRowCount() const;

Tampilkan Nilai

Jumlah baris tab dalam kontrol tab.

Keterangan

Hanya kontrol tab yang memiliki gaya yang TCS_MULTILINE dapat memiliki beberapa baris tab.

CTabCtrl::GetToolTips

Mengambil handel kontrol tips alat yang terkait dengan kontrol tab.

CToolTipCtrl* GetToolTips() const;

Tampilkan Nilai

Menangani kontrol tip alat jika berhasil; jika tidak NULL.

Keterangan

Kontrol tab membuat kontrol tip alat jika memiliki TCS_TOOLTIPS gaya. Anda juga dapat menetapkan kontrol tips alat ke kontrol tab dengan menggunakan SetToolTips fungsi anggota.

CTabCtrl::HighlightItem

Mengatur status sorotan item tab.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Parameter

idItem
Indeks berbasis nol dari item kontrol tab.

fHighlight
Nilai yang menentukan status sorotan yang akan diatur. Jika nilai ini adalah TRUE, tab disorot; jika FALSE, tab diatur ke status defaultnya.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Fungsi anggota ini mengimplementasikan pesan TCM_HIGHLIGHTITEMWin32 , seperti yang dijelaskan dalam Windows SDK.

CTabCtrl::HitTest

Menentukan tab mana, jika ada, berada pada posisi layar yang ditentukan.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parameter

pHitTestInfo
Penunjuk ke struktur, seperti yang TCHITTESTINFO dijelaskan dalam Windows SDK, yang menentukan posisi layar untuk diuji.

Tampilkan Nilai

Mengembalikan indeks berbasis nol tab atau -1 jika tidak ada tab pada posisi yang ditentukan.

CTabCtrl::InsertItem

Menyisipkan tab baru dalam kontrol tab yang sudah ada.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

Parameter

nItem
Indeks berbasis nol dari tab baru.

pTabCtrlItem
Penunjuk TCITEM ke struktur yang menentukan atribut tab.

lpszItem
Alamat string yang dihentikan null yang berisi teks tab.

nImage
Indeks gambar berbasis nol untuk disisipkan dari daftar gambar.

nMask
Menentukan atribut struktur mana yang TCITEM akan diatur. Bisa nol atau kombinasi dari nilai berikut:

• TCIF_TEXT: Anggota pszText valid.
• TCIF_IMAGE: Anggota iImage valid.
• TCIF_PARAM: Anggota lParam valid.
• TCIF_RTLREADING: Teks pszText ditampilkan menggunakan urutan baca kanan-ke-kiri pada sistem Ibrani atau Arab.
• TCIF_STATE: Anggota dwState valid.

lParam
Data yang ditentukan aplikasi yang terkait dengan tab.

dwState
Menentukan nilai untuk status item. Untuk informasi selengkapnya, lihat TCITEM di Windows SDK.

dwStateMask
Menentukan status mana yang akan diatur. Untuk informasi selengkapnya, lihat TCITEM di Windows SDK.

Tampilkan Nilai

Indeks berbasis nol dari tab baru jika berhasil; jika tidak -1.

Contoh

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Menghapus gambar yang ditentukan dari daftar gambar kontrol tab.

void RemoveImage(int nImage);

Parameter

nImage
Indeks gambar berbasis nol yang akan dihapus.

Keterangan

Kontrol tab memperbarui indeks gambar setiap tab sehingga setiap tab tetap terkait dengan gambar yang sama.

CTabCtrl::SetCurFocus

Mengatur fokus ke tab tertentu dalam kontrol tab.

void SetCurFocus(int nItem);

Parameter

nItem
Menentukan indeks tab yang mendapatkan fokus.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TCM_SETCURFOCUSWin32 , seperti yang dijelaskan dalam Windows SDK.

CTabCtrl::SetCurSel

Memilih tab dalam kontrol tab.

int SetCurSel(int nItem);

Parameter

nItem
Indeks berbasis nol dari item yang akan dipilih.

Tampilkan Nilai

Indeks berbasis nol dari tab yang dipilih sebelumnya jika berhasil, jika tidak -1.

Keterangan

Kontrol tab tidak mengirim TCN_SELCHANGING pesan pemberitahuan atau TCN_SELCHANGE saat tab dipilih menggunakan fungsi ini. Pemberitahuan ini dikirim, menggunakan WM_NOTIFY, saat pengguna mengklik atau menggunakan keyboard untuk mengubah tab.

CTabCtrl::SetExtendedStyle

Mengatur gaya yang diperluas untuk kontrol tab.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Parameter

dwNewStyle
Nilai yang menentukan kombinasi gaya yang diperluas kontrol tab.

dwExMask
Nilai DWORD yang menunjukkan gaya dwNewStyle mana yang akan terpengaruh. Hanya gaya yang diperluas di dwExMask yang akan diubah. Semua gaya lainnya akan dipertahankan apa adanya. Jika parameter ini nol, maka semua gaya di dwNewStyle akan terpengaruh.

Tampilkan Nilai

Nilai DWORD yang berisi kontrol tab sebelumnya memperluas gaya, seperti yang dijelaskan di Windows SDK.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TCM_SETEXTENDEDSTYLEWin32 , seperti yang dijelaskan dalam Windows SDK.

CTabCtrl::SetImageList

Menetapkan daftar gambar ke kontrol tab.

CImageList* SetImageList(CImageList* pImageList);

Parameter

pImageList
Penunjuk ke daftar gambar yang akan ditetapkan ke kontrol tab.

Tampilkan Nilai

Mengembalikan penunjuk ke daftar gambar sebelumnya atau NULL jika tidak ada daftar gambar sebelumnya.

CTabCtrl::SetItem

Mengatur beberapa atau semua atribut tab.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parameter

nItem
Indeks berbasis nol item.

pTabCtrlItem
Penunjuk TCITEM ke struktur yang berisi atribut item baru. Anggota mask menentukan atribut mana yang akan ditetapkan. mask Jika anggota menentukan TCIF_TEXT nilai, pszText anggota adalah alamat string yang dihentikan null dan cchTextMax anggota diabaikan.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Contoh

Lihat contoh untuk GetItem.

CTabCtrl::SetItemExtra

Mengatur jumlah byte per tab yang dicadangkan untuk data yang ditentukan aplikasi dalam kontrol tab.

BOOL SetItemExtra(int nBytes);

Parameter

nBytes
Jumlah byte tambahan yang akan diatur.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TCM_SETITEMEXTRAWin32 , seperti yang dijelaskan dalam Windows SDK.

CTabCtrl::SetItemSize

Mengatur lebar dan tinggi item kontrol tab.

CSize SetItemSize(CSize size);

Parameter

size
Lebar dan tinggi baru, dalam piksel, dari item kontrol tab.

Tampilkan Nilai

Mengembalikan lebar lama dan tinggi item kontrol tab.

CTabCtrl::SetItemState

Mengatur status item kontrol tab yang diidentifikasi oleh nItem.

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Parameter

nItem
Nomor indeks berbasis nol dari item untuk mengatur informasi status.

dwMask
Masker menentukan bendera status item mana yang akan diatur. Untuk daftar nilai, lihat anggota TCITEM mask struktur, seperti yang dijelaskan di Windows SDK.

dwState
Referensi ke nilai DWORD yang berisi informasi status. Dapat berupa salah satu dari nilai berikut:

Nilai	Deskripsi
TCIS_BUTTONPRESSED	Item kontrol tab dipilih.
TCIS_HIGHLIGHTED	Item kontrol tab disorot, dan tab dan teks digambar menggunakan warna sorotan saat ini. Saat menggunakan warna sorotan, ini akan menjadi interpolasi sejati, bukan warna terlarut.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

CTabCtrl::SetMinTabWidth

Mengatur lebar minimum item dalam kontrol tab.

int SetMinTabWidth(int cx);

Parameter

cx
Lebar minimum yang akan diatur untuk item kontrol tab. Jika parameter ini diatur ke -1, kontrol akan menggunakan lebar tab default.

Tampilkan Nilai

Lebar tab minimum sebelumnya.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TCM_SETMINTABWIDTHWin32 , seperti yang dijelaskan dalam Windows SDK.

CTabCtrl::SetPadding

Mengatur jumlah ruang (padding) di sekitar ikon dan label setiap tab dalam kontrol tab.

void SetPadding(CSize size);

Parameter

size
Mengatur jumlah ruang (padding) di sekitar ikon dan label setiap tab dalam kontrol tab.

CTabCtrl::SetToolTips

Menetapkan kontrol tips alat ke kontrol tab.

void SetToolTips(CToolTipCtrl* pWndTip);

Parameter

pWndTip
Menangani kontrol tip alat.

Keterangan

Anda bisa mendapatkan kontrol tip alat yang terkait dengan kontrol tab dengan melakukan panggilan ke GetToolTips.

Contoh

Lihat contoh untuk CPropertySheet::GetTabControl.

Lihat juga

CWnd Kelas
CHeaderCtrl Kelas
CListCtrl Kelas
Bagan Hierarki