CMFCHeaderCtrl Sınıfı
sınıfı, CMFCHeaderCtrl üst bilgi denetiminde birden çok sütunu sıralamayı destekler.
Sözdizimi
class CMFCHeaderCtrl : public CHeaderCtrl
Üyeler
Ortak Oluşturucular
| Ad | Tanım |
|---|---|
| CMFCHeaderCtrl::CMFCHeaderCtrl | Bir CMFCHeaderCtrl nesne oluşturur. |
CMFCHeaderCtrl::~CMFCHeaderCtrl |
Yıkıcı. |
Genel Yöntemler
| Ad | Tanım |
|---|---|
| CMFCHeaderCtrl::EnableMultipleSort | Geçerli üst bilgi denetimi için birden çok sütun sıralama modunu etkinleştirir veya devre dışı bırakır. |
| CMFCHeaderCtrl::GetColumnState | Sütunun sıralanmadığını veya artan veya azalan düzende sıralanıp sıralanmadığını gösterir. |
| CMFCHeaderCtrl::GetSortColumn | Üst bilgi denetimindeki ilk sıralanmış sütunun sıfır tabanlı dizinini alır. |
CMFCHeaderCtrl::GetThisClass |
Çerçeve tarafından, bu sınıf türüyle ilişkili CRuntimeClass nesnesine bir işaretçi almak için kullanılır. |
| CMFCHeaderCtrl::IsAscending | Üst bilgi denetimindeki herhangi bir sütunun artan düzende sıralanıp sıralanmadığını gösterir. |
| CMFCHeaderCtrl::IsDialogControl | Geçerli üst bilgi denetiminin üst penceresinin bir iletişim kutusu olup olmadığını gösterir. |
| CMFCHeaderCtrl::IsMultipleSort | Geçerli üst bilgi denetiminin birden çok sütun sıralama modunda olup olmadığını gösterir. |
| CMFCHeaderCtrl::RemoveSortColumn | Belirtilen sütunu sıralama sütunları listesinden kaldırır. |
| CMFCHeaderCtrl::SetSortColumn | Üst bilgi denetiminde belirtilen sütunun sıralama düzenini ayarlar. |
Korumalı Yöntemler
| Ad | Tanım |
|---|---|
| CMFCHeaderCtrl::OnDrawItem | Üst bilgi denetimi sütunu çizmek için çerçeve tarafından çağrılır. |
| CMFCHeaderCtrl::OnDrawSortArrow | Sıralama okunu çizmek için çerçeve tarafından çağrılır. |
| CMFCHeaderCtrl::OnFillBackground | Üst bilgi denetimi sütununun arka planını doldurmak için çerçeve tarafından çağrılır. |
Örnek
Aşağıdaki örnekte sınıfının bir nesnesinin CMFCHeaderCtrl nasıl oluşturileceği ve geçerli üst bilgi denetimi için birden çok sütun sıralama modunun nasıl etkinleştirileceği gösterilmektedir.
CMFCHeaderCtrl *headerCtrl = new CMFCHeaderCtrl();
headerCtrl->EnableMultipleSort();
Açıklamalar
sınıfı, CMFCHeaderCtrl üst bilgi denetimi sütununa bir sıralama oku çizerek sütunun sıralandığını gösterir. Üst liste denetimindeki bir sütun kümesi (CMFCListCtrl Sınıfı) aynı anda sıralanabilirse, birden çok sütun sıralama modunu kullanın.
Devralma Hiyerarşisi
Gereksinimler
Üst bilgi: afxheaderctrl.h
CMFCHeaderCtrl::CMFCHeaderCtrl
Bir CMFCHeaderCtrl nesne oluşturur.
CMFCHeaderCtrl::CMFCHeaderCtrl()
Açıklamalar
Bu oluşturucu, belirtilen değerler için aşağıdaki üye değişkenlerini başlatır:
| Üye değişkeni | Değer |
|---|---|
m_bIsMousePressed |
FALSE |
m_bMultipleSort |
FALSE |
m_bAscending |
DOĞRU |
m_nHighlightedItem |
-1 |
m_bTracked |
FALSE |
m_bIsDlgControl |
FALSE |
m_hFont |
NULL |
CMFCHeaderCtrl::EnableMultipleSort
Geçerli üst bilgi denetimi için birden çok sütun sıralama modunu etkinleştirir veya devre dışı bırakır.
void EnableMultipleSort(BOOL bEnable=TRUE);
Parametreler
bEnable
[in] Birden çok sütun sıralama modunu etkinleştirmek için TRUE; BIRDEN çok sütun sıralama modunu devre dışı bırakmak ve sıralanmış sütunlar listesinden sütunları kaldırmak için YANLIŞ. Varsayılan değer DOĞRU'dur.
Açıklamalar
Birden çok sütun sıralama modunu etkinleştirmek veya devre dışı bırakmak için bu yöntemi kullanın. Üst bilgi denetimi birden çok sütun sıralama modundaysa iki veya daha fazla sütun sıralamaya katılabilir.
CMFCHeaderCtrl::GetColumnState
Sütunun sıralı olmadığını veya artan veya azalan düzende sıralanıp sıralanmadığını gösterir.
int GetColumnState(int iColumn) const;
Parametreler
ıcolumn
[in] Bir sütunun sıfır tabanlı dizini.
İade Değeri
Belirtilen sütunun sıralama durumunu gösteren değer. Aşağıdaki tabloda olası değerler listelemektedir:
| Değer | Tanım |
|---|---|
| -1 | Azalan düzende sıralanır. |
| 0 | Sıralanmamış. |
| Kategori 1 | Artan düzende sıralanır. |
Açıklamalar
CMFCHeaderCtrl::GetSortColumn
Üst bilgi denetimindeki ilk sıralanmış sütunun sıfır tabanlı dizinini alır.
int GetSortColumn() const;
İade Değeri
Sıralanmış sütunun dizini veya sıralanmış sütun bulunamazsa -1.
Açıklamalar
Üst bilgi denetimi birden çok sütun sıralama modundaysa ve uygulamayı hata ayıklama modunda derlediyseniz, bu yöntem bunun yerine CMFCHeaderCtrl::GetColumnState yöntemini kullanmanızı onaylar ve önerir. Üst bilgi denetimi birden çok sütun sıralama modundaysa ve uygulamayı perakende modunda derlediyseniz, bu yöntem -1 döndürür.
CMFCHeaderCtrl::IsAscending
Üst bilgi denetimindeki herhangi bir sütunun artan düzende sıralanıp sıralanmadığını gösterir.
BOOL IsAscending() const;
İade Değeri
Üst bilgi denetimindeki herhangi bir sütun artan düzende sıralanmışsa DOĞRU; aksi takdirde YANLIŞ.
Açıklamalar
Bu yöntemin döndürdüğü değer, üst bilgi denetim öğesinde uygun sıralama okunu görüntülemek için kullanılır. Sıralama düzenini ayarlamak için CMFCHeaderCtrl::SetSortColumn yöntemini kullanın.
CMFCHeaderCtrl::IsDialogControl
Geçerli üst bilgi denetiminin üst penceresinin bir iletişim kutusu olup olmadığını gösterir.
BOOL IsDialogControl() const;
İade Değeri
Geçerli üst bilgi denetiminin üst penceresi bir iletişim kutusuysa DOĞRU; aksi takdirde YANLIŞ.
CMFCHeaderCtrl::IsMultipleSort
Geçerli üst bilgi denetiminin birden çok sütun sıralama modunda olup olmadığını gösterir.
BOOL IsMultipleSort() const;
İade Değeri
Birden çok sütun sıralama modu etkinse TRUE; aksi takdirde YANLIŞ.
Açıklamalar
Birden çok sütun sıralama modunu etkinleştirmek veya devre dışı bırakmak için CMFCHeaderCtrl::EnableMultipleSort yöntemini kullanın. Üst bilgi denetimi birden çok sütun sıralama modundaysa iki veya daha fazla sütun sıralamaya katılabilir.
CMFCHeaderCtrl::OnDrawItem
Üst bilgi denetimi sütunu çizmek için çerçeve tarafından çağrılır.
virtual void OnDrawItem(
CDC* pDC,
int iItem,
CRect rect,
BOOL bIsPressed,
BOOL bIsHighlighted);
Parametreler
Pdc
[in] Cihaz bağlamı işaretçisi.
iItem
[in] Çizecek öğenin sıfır tabanlı dizini.
Rect
[in] Çizilmesi gereken öğenin sınırlayıcı dikdörtgeni.
bIsPressed
[in] Öğeyi basılı durumda çizmek için TRUE; aksi takdirde YANLIŞ.
bIsHighlighted
[in] Öğeyi vurgulanmış durumda çizmek için TRUE; aksi takdirde YANLIŞ.
CMFCHeaderCtrl::OnDrawSortArrow
Sıralama okunu çizmek için çerçeve tarafından çağrılır.
virtual void OnDrawSortArrow(
CDC* pDC,
CRect rectArrow);
Parametreler
Pdc
[in] Cihaz bağlamı işaretçisi.
rectArrow
[in] Sıralama okunun sınırlayıcı dikdörtgeni.
CMFCHeaderCtrl::OnFillBackground
Üst bilgi denetimi sütununun arka planını doldurmak için çerçeve tarafından çağrılır.
virtual void OnFillBackground(CDC* pDC);
Parametreler
Pdc
[in] Cihaz bağlamı işaretçisi.
Açıklamalar
CMFCHeaderCtrl::RemoveSortColumn
Belirtilen sütunu sıralama sütunları listesinden kaldırır.
void RemoveSortColumn(int iColumn);
Parametreler
ıcolumn
[in] Kaldırılacak sütunun sıfır tabanlı dizini.
CMFCHeaderCtrl::SetSortColumn
Üst bilgi denetiminde belirtilen sütunun sıralama düzenini ayarlar.
void SetSortColumn(
int iColumn,
BOOL bAscending=TRUE,
BOOL bAdd=FALSE);
Parametreler
ıcolumn
[in] Üst bilgi denetim sütununun sıfır tabanlı dizini. Bu parametre sıfırdan küçükse, bu yöntem sıralama sütunları listesinden tüm sütunları kaldırır.
bAscending
[in] iColumn parametresinin belirttiği sütunun sıralama düzenini belirtir. Artan düzen ayarlamak için DOĞRU; Azalan düzeni ayarlamak için FALSE. Varsayılan değer DOĞRU'dur.
Baran
[in] iColumn parametresinin belirttiği sütunun sıralama düzenini ayarlamak için TRUE.
Geçerli üst bilgi denetimi birden çok sütun sıralama modundaysa, bu yöntem belirtilen sütunu sıralama sütunları listesine ekler. Birden çok sütun sıralama modunu ayarlamak için CMFCHeaderCtrl::EnableMultipleSort kullanın.
Birden çok sütun sıralama modu ayarlanmadıysa ve bu yöntem hata ayıklama modunda derlenmişse, bu yöntem onaylar. Birden çok sütun sıralama modu ayarlanmadıysa ve bu yöntem perakende modunda derlenmişse, bu yöntem önce sıralama sütunları listesinden tüm sütunları kaldırır ve sonra belirtilen sütunu listeye ekler.
ÖNCE sıralama sütunları listesinden tüm sütunları kaldırmak ve ardından belirtilen sütunu listeye eklemek için YANLIŞ. Varsayılan değer YANLIŞ'tır.
Açıklamalar
Bir sütunun sıralama düzenini ayarlamak için bu yöntemi kullanın. Gerekirse, bu yöntem sütunu sıralama sütunları listesine ekler. Üst bilgi denetimi, yukarı veya aşağı işaret eden bir sıralama oku çizmek için sıralama düzenini kullanır.