Aracılığıyla paylaş


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

Cobject

Ccmdtarget

Cwnd

CHeaderCtrl

CMFCHeaderCtrl

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.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCListCtrl Sınıfı