Kelas CMFCHeaderCtrl
Kelas CMFCHeaderCtrl mendukung pengurutan beberapa kolom dalam kontrol header.
Sintaks
class CMFCHeaderCtrl : public CHeaderCtrl
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CMFCHeaderctrl::CMFCHeaderctrl | Membuat CMFCHeaderCtrl objek. |
CMFCHeaderCtrl::~CMFCHeaderCtrl |
Destruktor. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CMFCHeaderCtrl::EnableMultipleSort | Mengaktifkan atau menonaktifkan beberapa mode pengurutan kolom untuk kontrol header saat ini. |
| CMFCHeaderCtrl::GetColumnState | Menunjukkan apakah kolom tidak diurutkan, atau diurutkan dalam urutan naik atau turun. |
| CMFCHeaderCtrl::GetSortColumn | Mengambil indeks berbasis nol dari kolom pertama yang diurutkan di kontrol header. |
CMFCHeaderCtrl::GetThisClass |
Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke objek CRuntimeClass yang terkait dengan jenis kelas ini. |
| CMFCHeaderctrl::IsAscending | Menunjukkan apakah ada kolom dalam kontrol header yang diurutkan dalam urutan naik. |
| CMFCHeaderCtrl::IsDialogControl | Menunjukkan apakah jendela induk kontrol header saat ini adalah kotak dialog. |
| CMFCHeaderCtrl::IsMultipleSort | Menunjukkan apakah kontrol header saat ini berada dalam mode pengurutan beberapa kolom. |
| CMFCHeaderCtrl::RemoveSortColumn | Menghapus kolom yang ditentukan dari daftar kolom pengurutan. |
| CMFCHeaderCtrl::SetSortColumn | Mengatur susunan urutan kolom tertentu dalam kontrol header. |
Metode yang Dilindungi
| Nama | Deskripsi |
|---|---|
| CMFCHeaderCtrl::OnDrawItem | Dipanggil oleh kerangka kerja untuk menggambar kolom kontrol header. |
| CMFCHeaderCtrl::OnDrawSortArrow | Dipanggil oleh kerangka kerja untuk menggambar panah pengurutan. |
| CMFCHeaderctrl::OnFillBackground | Dipanggil oleh kerangka kerja untuk mengisi latar belakang kolom kontrol header. |
Contoh
Contoh berikut menunjukkan cara membuat objek CMFCHeaderCtrl kelas, dan cara mengaktifkan beberapa mode pengurutan kolom untuk kontrol header saat ini.
CMFCHeaderCtrl *headerCtrl = new CMFCHeaderCtrl();
headerCtrl->EnableMultipleSort();
Keterangan
Kelas CMFCHeaderCtrl menggambar panah pengurutan pada kolom kontrol header untuk menunjukkan bahwa kolom diurutkan. Gunakan mode pengurutan beberapa kolom jika sekumpulan kolom dalam kontrol daftar induk ( Kelas CMFCListCtrl) dapat diurutkan secara bersamaan.
Hierarki Warisan
Persyaratan
Header: afxheaderctrl.h
CMFCHeaderctrl::CMFCHeaderctrl
Membuat CMFCHeaderCtrl objek.
CMFCHeaderCtrl::CMFCHeaderCtrl()
Keterangan
Konstruktor ini menginisialisasi variabel anggota berikut ke nilai yang ditentukan:
| Variabel anggota | Nilai |
|---|---|
m_bIsMousePressed |
SALAH |
m_bMultipleSort |
SALAH |
m_bAscending |
BENAR |
m_nHighlightedItem |
-1 |
m_bTracked |
SALAH |
m_bIsDlgControl |
SALAH |
m_hFont |
NULL |
CMFCHeaderCtrl::EnableMultipleSort
Mengaktifkan atau menonaktifkan beberapa mode pengurutan kolom untuk kontrol header saat ini.
void EnableMultipleSort(BOOL bEnable=TRUE);
Parameter
bEnable
[di] TRUE untuk mengaktifkan beberapa mode pengurutan kolom; FALSE untuk menonaktifkan beberapa mode pengurutan kolom dan untuk menghapus kolom apa pun dari daftar kolom yang diurutkan. Nilai defaultnya adalah TRUE.
Keterangan
Gunakan metode ini untuk mengaktifkan atau menonaktifkan beberapa mode pengurutan kolom. Dua kolom atau lebih dapat berpartisipasi dalam pengurutan jika kontrol header berada dalam mode pengurutan beberapa kolom.
CMFCHeaderCtrl::GetColumnState
Menunjukkan apakah kolom tidak diurutkan, atau diurutkan dalam urutan naik atau turun.
int GetColumnState(int iColumn) const;
Parameter
iColumn
[di] Indeks berbasis nol kolom.
Tampilkan Nilai
Nilai yang menunjukkan status pengurutan kolom yang ditentukan. Tabel berikut ini mencantumkan nilai yang mungkin:
| Nilai | Deskripsi |
|---|---|
| -1 | Diurutkan dalam urutan turun. |
| 0 | Tidak diurutkan. |
| 1 | Diurutkan dalam urutan naik. |
Keterangan
CMFCHeaderCtrl::GetSortColumn
Mengambil indeks berbasis nol dari kolom pertama yang diurutkan di kontrol header.
int GetSortColumn() const;
Tampilkan Nilai
Indeks kolom yang diurutkan, atau -1 jika tidak ada kolom yang diurutkan yang ditemukan.
Keterangan
Jika kontrol header berada dalam mode pengurutan beberapa kolom dan Anda mengkompilasi aplikasi dalam mode debug, metode ini menegaskan dan menyarankan Anda untuk menggunakan metode CMFCHeaderCtrl::GetColumnState sebagai gantinya. Jika kontrol header berada dalam mode pengurutan beberapa kolom dan Anda mengkompilasi aplikasi dalam mode ritel, metode ini mengembalikan -1.
CMFCHeaderctrl::IsAscending
Menunjukkan apakah ada kolom dalam kontrol header yang diurutkan dalam urutan naik.
BOOL IsAscending() const;
Tampilkan Nilai
TRUE jika ada kolom dalam kontrol header yang diurutkan dalam urutan naik; jika tidak, FALSE.
Keterangan
Nilai yang dikembalikan metode ini digunakan untuk menampilkan panah pengurutan yang sesuai pada item kontrol header. Gunakan metode CMFCHeaderCtrl::SetSortColumn untuk mengatur urutan pengurutan.
CMFCHeaderCtrl::IsDialogControl
Menunjukkan apakah jendela induk kontrol header saat ini adalah kotak dialog.
BOOL IsDialogControl() const;
Tampilkan Nilai
TRUE jika jendela induk kontrol header saat ini adalah kotak dialog; jika tidak, FALSE.
CMFCHeaderCtrl::IsMultipleSort
Menunjukkan apakah kontrol header saat ini berada dalam mode pengurutan beberapa kolom.
BOOL IsMultipleSort() const;
Tampilkan Nilai
TRUE jika beberapa mode pengurutan kolom diaktifkan; jika tidak, FALSE.
Keterangan
Gunakan metode CMFCHeaderCtrl::EnableMultipleSort untuk mengaktifkan atau menonaktifkan beberapa mode pengurutan kolom. Dua kolom atau lebih dapat berpartisipasi dalam pengurutan jika kontrol header berada dalam mode pengurutan beberapa kolom.
CMFCHeaderCtrl::OnDrawItem
Dipanggil oleh kerangka kerja untuk menggambar kolom kontrol header.
virtual void OnDrawItem(
CDC* pDC,
int iItem,
CRect rect,
BOOL bIsPressed,
BOOL bIsHighlighted);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
iItem
[di] Indeks berbasis nol dari item yang akan digambar.
rect
[di] Persegi panjang pembatas item yang akan digambar.
bIsPressed
[di] TRUE untuk menggambar item dalam status ditekan; jika tidak, FALSE.
bIsHighlighted
[di] TRUE untuk menggambar item dalam status disorot; jika tidak, FALSE.
CMFCHeaderCtrl::OnDrawSortArrow
Dipanggil oleh kerangka kerja untuk menggambar panah pengurutan.
virtual void OnDrawSortArrow(
CDC* pDC,
CRect rectArrow);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
rectArrow
[di] Persegi panjang pembatas panah pengurutan.
CMFCHeaderctrl::OnFillBackground
Dipanggil oleh kerangka kerja untuk mengisi latar belakang kolom kontrol header.
virtual void OnFillBackground(CDC* pDC);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
Keterangan
CMFCHeaderCtrl::RemoveSortColumn
Menghapus kolom yang ditentukan dari daftar kolom pengurutan.
void RemoveSortColumn(int iColumn);
Parameter
iColumn
[di] Indeks berbasis nol kolom yang akan dihapus.
CMFCHeaderCtrl::SetSortColumn
Mengatur susunan urutan kolom tertentu dalam kontrol header.
void SetSortColumn(
int iColumn,
BOOL bAscending=TRUE,
BOOL bAdd=FALSE);
Parameter
iColumn
[di] Indeks berbasis nol dari kolom kontrol header. Jika parameter ini kurang dari nol, metode ini akan menghapus semua kolom dari daftar kolom pengurutan.
bAscending
[di] Menentukan urutan pengurutan kolom yang ditentukan parameter iColumn . TRUE untuk mengatur urutan naik; FALSE untuk mengatur urutan turun. Nilai defaultnya adalah TRUE.
bTambahkan
[di] TRUE untuk mengatur urutan pengurutan kolom yang ditentukan parameter iColumn .
Jika kontrol header saat ini berada dalam mode pengurutan beberapa kolom, metode ini menambahkan kolom yang ditentukan ke daftar kolom pengurutan. Gunakan CMFCHeaderCtrl::EnableMultipleSort untuk mengatur beberapa mode pengurutan kolom.
Jika beberapa mode pengurutan kolom tidak diatur dan metode ini dikompilasi dalam mode debug, metode ini menegaskan. Jika beberapa mode pengurutan kolom tidak diatur dan metode ini dikompilasi dalam mode ritel, metode ini terlebih dahulu menghapus semua kolom dari daftar kolom pengurutan, lalu menambahkan kolom yang ditentukan ke daftar.
FALSE untuk terlebih dahulu menghapus semua kolom dari daftar kolom pengurutan, lalu tambahkan kolom yang ditentukan ke daftar. Nilai defaultnya adalah FALSE.
Keterangan
Gunakan metode ini untuk mengatur urutan pengurutan kolom. Jika perlu, metode ini menambahkan kolom ke daftar kolom pengurutan. Kontrol header menggunakan urutan pengurutan untuk menggambar panah pengurutan yang menunjuk ke atas atau ke bawah.