Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
De CMFCHeaderCtrl klasse ondersteunt het sorteren van meerdere kolommen in een koptekst.
Syntaxis
class CMFCHeaderCtrl : public CHeaderCtrl
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CMFCHeaderCtrl::CMFCHeaderCtrl | Maakt een CMFCHeaderCtrl object. |
CMFCHeaderCtrl::~CMFCHeaderCtrl |
Destructor. |
Openbare methoden
| Naam | Description |
|---|---|
| CMFCHeaderCtrl::EnableMultipleSort | Hiermee schakelt u de sorteermodus voor meerdere kolommen voor het huidige koptekstbeheer in of uit. |
| CMFCHeaderCtrl::GetColumnState | Geeft aan of een kolom niet is gesorteerd of in oplopende of aflopende volgorde wordt gesorteerd. |
| CMFCHeaderCtrl::GetSortColumn | Haalt de op nul gebaseerde index van de eerste gesorteerde kolom in het koptekstbesturingselement op. |
CMFCHeaderCtrl::GetThisClass |
Wordt door het framework gebruikt om een aanwijzer te verkrijgen naar het CRuntimeClass-object dat is gekoppeld aan dit klassetype. |
| CMFCHeaderCtrl::Isascending | Hiermee wordt aangegeven of een kolom in het koptekstbesturingselement in oplopende volgorde wordt gesorteerd. |
| CMFCHeaderCtrl::IsDialogControl | Hiermee wordt aangegeven of het bovenliggende venster van het huidige besturingselement voor koptekst een dialoogvenster is. |
| CMFCHeaderCtrl::IsMultipleSort | Hiermee wordt aangegeven of het huidige besturingselement voor kopteksten zich in de sorteermodus voor meerdere kolommen bevindt. |
| CMFCHeaderCtrl::RemoveSortColumn | Hiermee verwijdert u de opgegeven kolom uit de lijst met sorteerkolommen. |
| CMFCHeaderCtrl::SetSortColumn | Hiermee stelt u de sorteervolgorde van een opgegeven kolom in een koptekstbesturingselement in. |
Beveiligde methoden
| Naam | Description |
|---|---|
| CMFCHeaderCtrl::OnDrawItem | Wordt aangeroepen door het framework om een kolom met kopteksten te tekenen. |
| CMFCHeaderCtrl::OnDrawsortArrow | Aangeroepen door het framework om de sorteerpijl te tekenen. |
| CMFCHeaderCtrl::OnFillBackground | Wordt aangeroepen door het framework om de achtergrond van een kolom met kopteksten te vullen. |
Example
In het volgende voorbeeld ziet u hoe u een object van de CMFCHeaderCtrl klasse maakt en hoe u de sorteermodus voor meerdere kolommen inschakelt voor het huidige koptekstbeheer.
CMFCHeaderCtrl *headerCtrl = new CMFCHeaderCtrl();
headerCtrl->EnableMultipleSort();
Opmerkingen
De CMFCHeaderCtrl klasse tekent een sorteerpijl op een koptekstkolom om aan te geven dat de kolom is gesorteerd. Gebruik de sorteermodus voor meerdere kolommen als een set kolommen in het bovenliggende besturingselement voor lijsten ( CMFCListCtrl Class) tegelijkertijd kan worden gesorteerd.
Overnamehiërarchie
Requirements
Koptekst: afxheaderctrl.h
CMFCHeaderCtrl::CMFCHeaderCtrl
Maakt een CMFCHeaderCtrl object.
CMFCHeaderCtrl::CMFCHeaderCtrl()
Opmerkingen
Met deze constructor worden de volgende lidvariabelen geïnitialiseerd voor de opgegeven waarden:
| Lidvariabele | Waarde |
|---|---|
m_bIsMousePressed |
ONWAAR |
m_bMultipleSort |
ONWAAR |
m_bAscending |
TRUE |
m_nHighlightedItem |
-1 |
m_bTracked |
ONWAAR |
m_bIsDlgControl |
ONWAAR |
m_hFont |
NUL |
CMFCHeaderCtrl::EnableMultipleSort
Hiermee schakelt u de sorteermodus voor meerdere kolommen voor het huidige koptekstbeheer in of uit.
void EnableMultipleSort(BOOL bEnable=TRUE);
Parameterwaarden
bEnable
[in] TRUE om de sorteermodus voor meerdere kolommen in te schakelen; FALSE om de sorteermodus voor meerdere kolommen uit te schakelen en kolommen uit de lijst met gesorteerde kolommen te verwijderen. De standaardwaarde is WAAR.
Opmerkingen
Gebruik deze methode om de sorteermodus voor meerdere kolommen in of uit te schakelen. Twee of meer kolommen kunnen deelnemen aan een sortering als het besturingselement voor kopteksten zich in de sorteermodus voor meerdere kolommen bevindt.
CMFCHeaderCtrl::GetColumnState
Geeft aan of een kolom niet is gesorteerd of in oplopende of aflopende volgorde is gesorteerd.
int GetColumnState(int iColumn) const;
Parameterwaarden
iColumn
[in] De op nul gebaseerde index van een kolom.
Retourwaarde
Een waarde die de sorteerstatus van de opgegeven kolom aangeeft. De volgende tabel bevat de mogelijke waarden:
| Waarde | Description |
|---|---|
| -1 | Gesorteerd in aflopende volgorde. |
| 0 | Niet gesorteerd. |
| 1 | Gesorteerd in oplopende volgorde. |
Opmerkingen
CMFCHeaderCtrl::GetSortColumn
Haalt de op nul gebaseerde index van de eerste gesorteerde kolom in het koptekstbesturingselement op.
int GetSortColumn() const;
Retourwaarde
De index van een gesorteerde kolom of -1 als er geen gesorteerde kolom wordt gevonden.
Opmerkingen
Als het besturingselement voor kopteksten zich in de sorteermodus voor meerdere kolommen bevindt en u de toepassing hebt gecompileerd in de foutopsporingsmodus, wordt met deze methode bevestigd en wordt u geadviseerd om in plaats daarvan de methode CMFCHeaderCtrl::GetColumnState te gebruiken. Als het besturingselement voor kopteksten zich in de sorteermodus van meerdere kolommen bevindt en u de toepassing hebt gecompileerd in de handelsmodus, retourneert deze methode -1.
CMFCHeaderCtrl::Isascending
Hiermee wordt aangegeven of een kolom in het koptekstbesturingselement in oplopende volgorde wordt gesorteerd.
BOOL IsAscending() const;
Retourwaarde
WAAR als een kolom in het koptekstbesturingselement in oplopende volgorde wordt gesorteerd; anders, ONWAAR.
Opmerkingen
De waarde die door deze methode wordt geretourneerd, wordt gebruikt om de juiste sorteerpijl weer te geven op het item van het besturingselement voor de koptekst. Gebruik de methode CMFCHeaderCtrl::SetSortColumn om de sorteervolgorde in te stellen.
CMFCHeaderCtrl::IsDialogControl
Hiermee wordt aangegeven of het bovenliggende venster van het huidige besturingselement voor koptekst een dialoogvenster is.
BOOL IsDialogControl() const;
Retourwaarde
WAAR als het bovenliggende venster van het huidige besturingselement voor koptekst een dialoogvenster is; anders, ONWAAR.
CMFCHeaderCtrl::IsMultipleSort
Hiermee wordt aangegeven of het huidige besturingselement voor kopteksten zich in de sorteermodus voor meerdere kolommen bevindt.
BOOL IsMultipleSort() const;
Retourwaarde
WAAR als de sorteermodus voor meerdere kolommen is ingeschakeld; anders, ONWAAR.
Opmerkingen
Gebruik de methode CMFCHeaderCtrl::EnableMultipleSort om de sorteermodus voor meerdere kolommen in of uit te schakelen. Twee of meer kolommen kunnen deelnemen aan een sortering als het besturingselement voor kopteksten zich in de sorteermodus voor meerdere kolommen bevindt.
CMFCHeaderCtrl::OnDrawItem
Wordt aangeroepen door het framework om een kolom met kopteksten te tekenen.
virtual void OnDrawItem(
CDC* pDC,
int iItem,
CRect rect,
BOOL bIsPressed,
BOOL bIsHighlighted);
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
iItem
[in] De op nul gebaseerde index van het item dat moet worden getekend.
Rect
[in] De begrenzingsrechthoek van het item dat moet worden getekend.
bIsPressed
[in] WAAR om het item in de gedrukte toestand te tekenen; anders, ONWAAR.
bIsHighlighted
[in] WAAR om het item in gemarkeerde staat te tekenen; anders, ONWAAR.
CMFCHeaderCtrl::OnDrawsortArrow
Aangeroepen door het framework om de sorteerpijl te tekenen.
virtual void OnDrawSortArrow(
CDC* pDC,
CRect rectArrow);
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
rectArrow
[in] De begrenzingsrechthoek van de sorteerpijl.
CMFCHeaderCtrl::OnFillBackground
Wordt aangeroepen door het framework om de achtergrond van een kolom met kopteksten te vullen.
virtual void OnFillBackground(CDC* pDC);
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
Opmerkingen
CMFCHeaderCtrl::RemoveSortColumn
Hiermee verwijdert u de opgegeven kolom uit de lijst met sorteerkolommen.
void RemoveSortColumn(int iColumn);
Parameterwaarden
iColumn
[in] De op nul gebaseerde index van de kolom die moet worden verwijderd.
CMFCHeaderCtrl::SetSortColumn
Hiermee stelt u de sorteervolgorde van een opgegeven kolom in een koptekstbesturingselement in.
void SetSortColumn(
int iColumn,
BOOL bAscending=TRUE,
BOOL bAdd=FALSE);
Parameterwaarden
iColumn
[in] De op nul gebaseerde index van een kolom met koptekstbesturingselementen. Als deze parameter kleiner is dan nul, worden met deze methode alle kolommen uit de lijst met sorteerkolommen verwijderd.
bAscending
[in] Hiermee geeft u de sorteervolgorde op van de kolom die de parameter iColumn opgeeft. WAAR om oplopende volgorde in te stellen; FALSE om aflopende volgorde in te stellen. De standaardwaarde is WAAR.
bAdd
[in] TRUE om de sorteervolgorde in te stellen van de kolom die de parameter iColumn opgeeft.
Als het huidige besturingselement voor kopteksten zich in de sorteermodus voor meerdere kolommen bevindt, wordt met deze methode de opgegeven kolom toegevoegd aan de lijst met sorteerkolommen. Gebruik CMFCHeaderCtrl::EnableMultipleSort om de sorteermodus voor meerdere kolommen in te stellen.
Als de sorteermodus voor meerdere kolommen niet is ingesteld en deze methode wordt gecompileerd in de foutopsporingsmodus, wordt deze methode gebruikt. Als de sorteermodus voor meerdere kolommen niet is ingesteld en deze methode wordt gecompileerd in de handelsmodus, worden eerst alle kolommen uit de lijst met sorteerkolommen verwijderd en wordt vervolgens de opgegeven kolom toegevoegd aan de lijst.
FALSE om eerst alle kolommen uit de lijst met sorteerkolommen te verwijderen en vervolgens de opgegeven kolom toe te voegen aan de lijst. De standaardwaarde is FALSE.
Opmerkingen
Gebruik deze methode om de sorteervolgorde van een kolom in te stellen. Indien nodig voegt deze methode de kolom toe aan de lijst met sorteerkolommen. Het koptekstbesturingselement gebruikt de sorteervolgorde om een sorteerpijl te tekenen die omhoog of omlaag wijst.