CMFCHeaderCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CMFCHeaderCtrl osztály több oszlop rendezését is támogatja egy fejlécvezérlőben.

Szemantika

class CMFCHeaderCtrl : public CHeaderCtrl

Tagok

Nyilvános konstruktorok

Név	Description
CMFCHeaderCtrl::CMFCHeaderCtrl	Egy CMFCHeaderCtrl objektumot hoz létre.
CMFCHeaderCtrl::~CMFCHeaderCtrl	Destruktor.

Nyilvános metódusok

Név	Description
CMFCHeaderCtrl::EnableMultipleSort	Engedélyezi vagy letiltja a több oszlop rendezési módját az aktuális fejlécvezérlőhöz.
CMFCHeaderCtrl::GetColumnState	Azt jelzi, hogy egy oszlop nincs rendezve, vagy növekvő vagy csökkenő sorrendben van-e rendezve.
CMFCHeaderCtrl::GetSortColumn	A fejléc vezérlőelem első rendezett oszlopának nulla alapú indexét kéri le.
CMFCHeaderCtrl::GetThisClass	A keretrendszer az ehhez az osztálytípushoz társított CRuntimeClass objektumra mutató mutató lekéréséhez használja.
CMFCHeaderCtrl::IsAscending	Azt jelzi, hogy a fejléc vezérlőelem bármelyik oszlopa növekvő sorrendben van-e rendezve.
CMFCHeaderCtrl::IsDialogControl	Azt jelzi, hogy az aktuális fejlécvezérlő szülőablaka párbeszédpanel-e.
CMFCHeaderCtrl::IsMultipleSort	Azt jelzi, hogy az aktuális fejlécvezérlő több oszlop rendezési módban van-e.
CMFCHeaderCtrl::RemoveSortColumn	Eltávolítja a megadott oszlopot a rendezési oszlopok listájából.
CMFCHeaderCtrl::SetSortColumn	Egy adott oszlop rendezési sorrendjét állítja be egy fejlécvezérlőben.

Védett metódusok

Név	Description
CMFCHeaderCtrl::OnDrawItem	A keretrendszer meghívta, hogy rajzoljon egy fejlécvezérlő oszlopot.
CMFCHeaderCtrl::OnDrawSortArrow	A keretrendszer meghívta a rendezési nyíl rajzolásához.
CMFCHeaderCtrl::OnFillBackground	A keretrendszer meghívta, hogy kitöltse egy fejlécvezérlő oszlop hátterét.

Example

Az alábbi példa bemutatja, hogyan hozhat létre egy objektumot az CMFCHeaderCtrl osztályban, és hogyan engedélyezheti több oszlop rendezési módját az aktuális fejlécvezérlőhöz.

CMFCHeaderCtrl *headerCtrl = new CMFCHeaderCtrl();
headerCtrl->EnableMultipleSort();

Megjegyzések

Az CMFCHeaderCtrl osztály egy rendezési nyilat rajzol egy fejlécvezérlő oszlopra, amely azt jelzi, hogy az oszlop rendezve van. Több oszlop rendezési módot is használhat, ha a szülőlista vezérlőelem (CMFCListCtrl osztály) oszlopkészlete egyszerre rendezhető.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CHeaderCtrl

CMFCHeaderCtrl

Requirements

Fejléc: afxheaderctrl.h

CMFCHeaderCtrl::CMFCHeaderCtrl

Egy CMFCHeaderCtrl objektumot hoz létre.

CMFCHeaderCtrl::CMFCHeaderCtrl()

Megjegyzések

Ez a konstruktor inicializálja a következő tagváltozókat a megadott értékekre:

Tagváltozó	Érték
m_bIsMousePressed	FALSE
m_bMultipleSort	FALSE
m_bAscending	TRUE
m_nHighlightedItem	-1
m_bTracked	FALSE
m_bIsDlgControl	FALSE
m_hFont	NULLA

CMFCHeaderCtrl::EnableMultipleSort

Engedélyezi vagy letiltja a több oszlop rendezési módját az aktuális fejlécvezérlőhöz.

void EnableMultipleSort(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] IGAZ érték több oszlop rendezési mód engedélyezéséhez; HAMIS, ha letilt több oszlop rendezési módot, és eltávolít minden oszlopot a rendezett oszlopok listájából. Az alapértelmezett érték TRUE.

Megjegyzések

Ezzel a módszerrel engedélyezheti vagy letilthatja a több oszlop szerinti rendezési módot. Két vagy több oszlop akkor vehet részt a rendezésben, ha a fejléc vezérlőelem több oszlop rendezési módban van.

CMFCHeaderCtrl::GetColumnState

Azt jelzi, hogy egy oszlop rendezetlen-e, vagy növekvő vagy csökkenő sorrendben van-e rendezve.

int GetColumnState(int iColumn) const;

Paraméterek

iColumn
[in] Egy oszlop nulla alapú indexe.

Visszaadott érték

A megadott oszlop rendezési állapotát jelző érték. Az alábbi táblázat a lehetséges értékeket sorolja fel:

Érték	Description
-1	Csökkenő sorrendben rendezve.
0	Nincs rendezve.
1	Növekvő sorrendben rendezve.

Megjegyzések

CMFCHeaderCtrl::GetSortColumn

A fejléc vezérlőelem első rendezett oszlopának nulla alapú indexét kéri le.

int GetSortColumn() const;

Visszaadott érték

Egy rendezett oszlop indexe, vagy ha nem található rendezett oszlop, -1.

Megjegyzések

Ha a fejlécvezérlő több oszlop rendezési módban van, és hibakeresési módban fordította le az alkalmazást, ez a módszer azt állítja, és azt tanácsolja, hogy inkább a CMFCHeaderCtrl::GetColumnState metódust használja. Ha a fejléc vezérlőelem több oszlop rendezési módban van, és az alkalmazást kiskereskedelmi módban állította össze, ez a metódus -1 értéket ad vissza.

CMFCHeaderCtrl::IsAscending

Azt jelzi, hogy a fejléc vezérlőelem bármelyik oszlopa növekvő sorrendben van-e rendezve.

BOOL IsAscending() const;

Visszaadott érték

IGAZ, ha a fejléc vezérlőelem bármelyik oszlopa növekvő sorrendben van rendezve; egyéb esetben HAMIS.

Megjegyzések

A metódus által visszaadott érték a megfelelő rendezési nyíl megjelenítésére szolgál az élőfej vezérlőelemén. A rendezési sorrend beállításához használja a CMFCHeaderCtrl::SetSortColumn metódust .

CMFCHeaderCtrl::IsDialogControl

Azt jelzi, hogy az aktuális fejlécvezérlő szülőablaka párbeszédpanel-e.

BOOL IsDialogControl() const;

Visszaadott érték

IGAZ, ha az aktuális fejlécvezérlő szülőablaka párbeszédpanel; egyéb esetben HAMIS.

CMFCHeaderCtrl::IsMultipleSort

Azt jelzi, hogy az aktuális fejlécvezérlő több oszlop rendezési módban van-e.

BOOL IsMultipleSort() const;

Visszaadott érték

IGAZ, ha több oszlop rendezési mód engedélyezve van; egyéb esetben HAMIS.

Megjegyzések

Használja a CMFCHeaderCtrl::EnableMultipleSort metódust több oszlop rendezési mód engedélyezéséhez vagy letiltásához. Két vagy több oszlop akkor vehet részt a rendezésben, ha a fejléc vezérlőelem több oszlop rendezési módban van.

CMFCHeaderCtrl::OnDrawItem

A keretrendszer meghívta, hogy rajzoljon egy fejlécvezérlő oszlopot.

virtual void OnDrawItem(
    CDC* pDC,
    int iItem,
    CRect rect,
    BOOL bIsPressed,
    BOOL bIsHighlighted);

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

iItem
[in] A rajzolni kívánt elem nulla alapú indexe.

téglalap
[in] A rajzolni kívánt elem határoló téglalapja.

bIsPressed
[in] IGAZ, ha lenyomott állapotban szeretné rajzolni az elemet; egyéb esetben HAMIS.

bIsHighlighted
[in] IGAZ, ha az elemet kiemelt állapotban szeretné rajzolni; egyéb esetben HAMIS.

CMFCHeaderCtrl::OnDrawSortArrow

A keretrendszer meghívta a rendezési nyíl rajzolásához.

virtual void OnDrawSortArrow(
    CDC* pDC,
    CRect rectArrow);

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

rectArrow
[in] A rendezési nyíl határoló téglalapja.

CMFCHeaderCtrl::OnFillBackground

A keretrendszer meghívta, hogy kitöltse egy fejlécvezérlő oszlop hátterét.

virtual void OnFillBackground(CDC* pDC);

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

Megjegyzések

CMFCHeaderCtrl::RemoveSortColumn

Eltávolítja a megadott oszlopot a rendezési oszlopok listájából.

void RemoveSortColumn(int iColumn);

Paraméterek

iColumn
[in] Az eltávolítandó oszlop nulla alapú indexe.

CMFCHeaderCtrl::SetSortColumn

Egy adott oszlop rendezési sorrendjét állítja be egy fejlécvezérlőben.

void SetSortColumn(
    int iColumn,
    BOOL bAscending=TRUE,
    BOOL bAdd=FALSE);

Paraméterek

iColumn
[in] A fejlécvezérlő oszlop nulla alapú indexe. Ha ez a paraméter nullánál kisebb, ez a metódus eltávolítja az összes oszlopot a rendezési oszlopok listájából.

bA növekvő
[in] Az iColumn paraméter által megadott oszlop rendezési sorrendjét adja meg. IGAZ a növekvő sorrend beállításához; HAMIS a csökkenő sorrend beállításához. Az alapértelmezett érték TRUE.

bAdd
[in] IGAZ az iColumn paraméter által megadott oszlop rendezési sorrendjének beállításához.

Ha az aktuális fejléc vezérlőelem több oszlop rendezési módban van, ez a metódus hozzáadja a megadott oszlopot a rendezési oszlopok listájához. Használja a CMFCHeaderCtrl::EnableMultipleSort parancsot több oszlop rendezési mód beállításához.

Ha nincs beállítva több oszlop rendezési mód, és a metódus hibakeresési módban van lefordítva, ez a módszer érvényes. Ha nincs beállítva több oszlop rendezési mód, és ezt a metódust kiskereskedelmi módban fordítja le, ez a módszer először eltávolítja az összes oszlopot a rendezési oszlopok listájából, majd hozzáadja a megadott oszlopot a listához.

HAMIS: először távolítsa el az összes oszlopot a rendezési oszlopok listájából, majd adja hozzá a megadott oszlopot a listához. Az alapértelmezett érték HAMIS.

Megjegyzések

Ezzel a módszerrel állíthatja be egy oszlop rendezési sorrendjét. Szükség esetén ez a metódus hozzáadja az oszlopot a rendezési oszlopok listájához. A fejléc vezérlőelem a rendezési sorrend használatával rajzol felfelé vagy lefelé mutató rendezési nyilat.

Lásd még

hierarchiadiagram
osztályok
CMFCListCtrl osztály