CListCtrl-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Hiermee wordt de functionaliteit ingekapseld van een 'besturingselement voor lijstweergave', waarin een verzameling items wordt weergegeven die elk bestaan uit een pictogram (uit een lijst met afbeeldingen) en een label.

Syntaxis

class CListCtrl : public CWnd

Leden

Openbare constructors

Naam	Description
CListCtrl::CListCtrl	Maakt een CListCtrl object.

Openbare methoden

Naam	Description
CListCtrl::ApproximateViewRect	Bepaalt de breedte en hoogte die vereist zijn om de items van een besturingselement voor de lijstweergave weer te geven.
CListCtrl::Arrange	Hiermee worden items in een raster uitgelijnd.
CListCtrl::CancelEditLabel	Hiermee annuleert u de bewerking voor het bewerken van itemteksten.
CListCtrl::Create	Hiermee maakt u een lijst besturingselement en koppelt u dit aan een CListCtrl object.
CListCtrl::CreateDragImage	Hiermee maakt u een lijst met sleepafbeeldingen voor een opgegeven item.
CListCtrl::CreateEx	Hiermee maakt u een lijst besturingselement met de opgegeven uitgebreide Stijlen van Windows en koppelt u dit aan een CListCtrl object.
CListCtrl::DeleteAllItems	Hiermee verwijdert u alle items uit het besturingselement.
CListCtrl::DeleteColumn	Hiermee verwijdert u een kolom uit het besturingselement lijstweergave.
CListCtrl::DeleteItem	Hiermee verwijdert u een item uit het besturingselement.
CListCtrl::DrawItem	Aangeroepen wanneer een visueel aspect van een besturingselement eigenaar tekenen verandert.
CListCtrl::EditLabel	Begint met het in-place bewerken van de tekst van een item.
CListCtrl::EnableGroupView	Hiermee schakelt u in of uit of de items in een besturingselement voor de lijstweergave als groep worden weergegeven.
CListCtrl::EnsureVisible	Zorgt ervoor dat een item zichtbaar is.
CListCtrl::FindItem	Hiermee wordt gezocht naar een lijstweergave-item met opgegeven kenmerken.
CListCtrl::GetBkColor	Hiermee haalt u de achtergrondkleur van een besturingselement voor de lijstweergave op.
CListCtrl::GetBkImage	Hiermee haalt u de huidige achtergrondafbeelding van een besturingselement voor de lijstweergave op.
CListCtrl::GetCallbackMask	Hiermee haalt u het callbackmasker voor een besturingselement voor de lijstweergave op.
CListCtrl::GetCheck	Hiermee wordt de huidige weergavestatus opgehaald van de statusafbeelding die is gekoppeld aan een item.
CListCtrl::GetColumn	Haalt de kenmerken van de kolom van een besturingselement op.
CListCtrl::GetColumnOrderArray	Hiermee haalt u de kolomvolgorde (van links naar rechts) van een besturingselement voor de lijstweergave op.
CListCtrl::GetColumnWidth	Hiermee haalt u de breedte van een kolom in de rapportweergave of lijstweergave op.
CListCtrl::GetCountPerPage	Berekent het aantal items dat verticaal in een besturingselement voor de lijstweergave past.
CListCtrl::GetEditControl	Hiermee wordt de ingang opgehaald van het besturingselement bewerken dat wordt gebruikt om de tekst van een item te bewerken.
CListCtrl::GetEmptyText	Hiermee wordt de tekenreeks opgehaald die moet worden weergegeven als het huidige besturingselement voor de lijstweergave leeg is.
CListCtrl::GetExtendedStyle	Hiermee haalt u de huidige uitgebreide stijlen van een besturingselement voor de lijstweergave op.
CListCtrl::GetFirstSelectedItemPosition	Hiermee haalt u de positie van het eerste geselecteerde lijstweergave-item op in een besturingselement voor de lijstweergave.
CListCtrl::GetFocusedGroup	Haalt de groep met de toetsenbordfocus op in het huidige besturingselement voor lijstweergave.
CListCtrl::GetGroupCount	Hiermee haalt u het aantal groepen op in het huidige besturingselement voor de lijstweergave.
CListCtrl::GetGroupInfo	Hiermee haalt u de informatie op voor een opgegeven groep van het besturingselement lijstweergave.
CListCtrl::GetGroupInfoByIndex	Hiermee wordt informatie opgehaald over een opgegeven groep in het huidige besturingselement voor de lijstweergave.
CListCtrl::GetGroupMetrics	Haalt de metrische gegevens van een groep op.
CListCtrl::GetGroupRect	Hiermee haalt u de begrenzingsrechthoek voor een opgegeven groep op in het huidige besturingselement voor lijstweergave.
CListCtrl::GetGroupState	Haalt de status voor een opgegeven groep op in het huidige besturingselement voor lijstweergave.
CListCtrl::GetHeaderCtrl	Hiermee haalt u het besturingselement koptekst van een besturingselement voor de lijstweergave op.
CListCtrl::GetHotCursor	Hiermee haalt u de cursor op die wordt gebruikt wanneer dynamisch bijhouden is ingeschakeld voor een besturingselement voor de lijstweergave.
CListCtrl::GetHotItem	Hiermee haalt u het lijstweergave-item op dat zich momenteel onder de cursor bevindt.
CListCtrl::GetHoverTime	Hiermee haalt u de huidige aanwijstijd van een besturingselement voor de lijstweergave op.
CListCtrl::GetImageList	Hiermee wordt de greep opgehaald van een lijst met afbeeldingen die wordt gebruikt voor items in de lijstweergave van de tekening.
CListCtrl::GetInsertMark	Hiermee haalt u de huidige positie van de invoegmarkering op.
CListCtrl::GetInsertMarkColor	Hiermee wordt de huidige kleur van de invoegmarkering opgehaald.
CListCtrl::GetInsertMarkRect	Hiermee haalt u de rechthoek op die de invoegpositie begrenst.
CListCtrl::GetItem	Hiermee worden de kenmerken van een lijstweergave-item opgehaald.
CListCtrl::GetItemCount	Hiermee haalt u het aantal items in een besturingselement voor de lijstweergave op.
CListCtrl::GetItemData	Hiermee haalt u de toepassingsspecifieke waarde op die is gekoppeld aan een item.
CListCtrl::GetItemIndexRect	Hiermee wordt de begrenzingsrechthoek opgehaald voor alle of een deel van een subitem in het huidige besturingselement voor lijstweergave.
CListCtrl::GetItemPosition	Hiermee haalt u de positie van een lijstweergave-item op.
CListCtrl::GetItemRect	Hiermee haalt u de begrenzingsrechthoek voor een item op.
CListCtrl::GetItemSpacing	Berekent de afstand tussen items in het huidige besturingselement voor de lijstweergave.
CListCtrl::GetItemState	Hiermee haalt u de status van een lijstweergave-item op.
CListCtrl::GetItemText	Hiermee haalt u de tekst van een lijstweergave-item of subitem op.
CListCtrl::GetNextItem	Zoekt naar een lijstweergave-item met opgegeven eigenschappen en met een opgegeven relatie met een bepaald item.
CListCtrl::GetNextItemIndex	Haalt de index van het item op in het huidige besturingselement voor lijstweergave met een opgegeven set eigenschappen.
CListCtrl::GetNextSelectedItem	Hiermee haalt u de index van de positie van een lijstweergave-item op en de positie van het volgende geselecteerde lijstweergave-item voor herhalen.
CListCtrl::GetNumberOfWorkAreas	Hiermee haalt u het huidige aantal werkgebieden voor een besturingselement voor de lijstweergave op.
CListCtrl::GetOrigin	Hiermee haalt u de huidige oorsprong van de weergave op voor een besturingselement voor de lijstweergave.
CListCtrl::GetOutlineColor	Hiermee wordt de kleur van de rand van een besturingselement voor de lijstweergave opgehaald.
CListCtrl::GetSelectedColumn	Hiermee haalt u de index van de momenteel geselecteerde kolom in het lijstbeheer op.
CListCtrl::GetSelectedCount	Hiermee haalt u het aantal geselecteerde items op in het besturingselement lijstweergave.
CListCtrl::GetSelectionMark	Hiermee haalt u de selectiemarkering van een besturingselement voor de lijstweergave op.
CListCtrl::GetStringWidth	Bepaalt de minimale kolombreedte die nodig is om alle tekenreeksen weer te geven.
CListCtrl::GetSubItemRect	Hiermee haalt u de begrenzingsrechthoek van een item op in een besturingselement voor de lijstweergave.
CListCtrl::GetTextBkColor	Hiermee haalt u de achtergrondkleur van de tekst van een besturingselement voor de lijstweergave op.
CListCtrl::GetTextColor	Hiermee haalt u de tekstkleur van een besturingselement voor de lijstweergave op.
CListCtrl::GetTileInfo	Hiermee haalt u informatie over een tegel op in een besturingselement voor de lijstweergave.
CListCtrl::GetTileViewInfo	Hiermee wordt informatie opgehaald over een besturingselement voor de lijstweergave in de tegelweergave.
CListCtrl::GetToolTips	Hiermee haalt u het besturingselement knopinfo op dat door het besturingselement voor de lijstweergave wordt gebruikt om knopinfo weer te geven.
CListCtrl::GetTopIndex	Haalt de index van het bovenste zichtbare item op.
CListCtrl::GetView	Hiermee haalt u de weergave van het besturingselement lijstweergave op.
CListCtrl::GetViewRect	Hiermee haalt u de begrenzingsrechthoek van alle items in het besturingselement lijstweergave op.
CListCtrl::GetWorkAreas	Hiermee worden de huidige werkgebieden van een besturingselement voor de lijstweergave opgehaald.
CListCtrl::HasGroup	Bepaalt of het besturingselement voor de lijstweergave de opgegeven groep heeft.
CListCtrl::HitTest	Bepaalt welk lijstweergave-item zich op een opgegeven positie bevindt.
CListCtrl::InsertColumn	Hiermee voegt u een nieuwe kolom in een besturingselement voor de lijstweergave in.
CListCtrl::InsertGroup	Hiermee voegt u een groep in het besturingselement lijstweergave in.
CListCtrl::InsertGroupSorted	Hiermee voegt u de opgegeven groep in een geordende lijst met groepen in.
CListCtrl::InsertItem	Hiermee voegt u een nieuw item in een besturingselement voor de lijstweergave in.
CListCtrl::InsertMarkHitTest	Hiermee wordt de invoegpositie opgehaald die het dichtst bij een opgegeven punt ligt.
CListCtrl::IsGroupViewEnabled	Bepaalt of de groepsweergave is ingeschakeld voor een besturingselement voor de lijstweergave.
CListCtrl::IsItemVisible	Hiermee wordt aangegeven of een opgegeven item in het huidige besturingselement voor lijstweergave zichtbaar is.
CListCtrl::MapIDToIndex	Hiermee wordt de unieke id van een item in het huidige besturingselement voor de lijstweergave toegewezen aan een index.
CListCtrl::MapIndexToID	Hiermee wordt de index van een item in het huidige besturingselement voor de lijstweergave toegewezen aan een unieke id.
CListCtrl::MoveGroup	Hiermee verplaatst u de opgegeven groep.
CListCtrl::MoveItemToGroup	Hiermee verplaatst u de opgegeven groep naar de opgegeven op nul gebaseerde index van het besturingselement lijstweergave.
CListCtrl::RedrawItems	Hiermee dwingt u een besturingselement voor de lijstweergave om een reeks items opnieuw te maken.
CListCtrl::RemoveAllGroups	Hiermee verwijdert u alle groepen uit een besturingselement voor de lijstweergave.
CListCtrl::RemoveGroup	Hiermee verwijdert u de opgegeven groep uit het besturingselement lijstweergave.
CListCtrl::Scroll	Hiermee schuift u door de inhoud van een besturingselement voor de lijstweergave.
CListCtrl::SetBkColor	Hiermee stelt u de achtergrondkleur van het besturingselement lijstweergave in.
CListCtrl::SetBkImage	Hiermee stelt u de huidige achtergrondafbeelding van een besturingselement voor de lijstweergave in.
CListCtrl::SetCallbackMask	Hiermee stelt u het callbackmasker in voor een besturingselement voor de lijstweergave.
CListCtrl::SetCheck	Hiermee stelt u de huidige weergavestatus in van de statusafbeelding die is gekoppeld aan een item.
CListCtrl::SetColumn	Hiermee stelt u de kenmerken van een lijstweergavekolom in.
CListCtrl::SetColumnOrderArray	Hiermee stelt u de kolomvolgorde (van links naar rechts) van een besturingselement voor de lijstweergave in.
CListCtrl::SetColumnWidth	Hiermee wijzigt u de breedte van een kolom in de rapportweergave of lijstweergave.
CListCtrl::SetExtendedStyle	Hiermee stelt u de huidige uitgebreide stijlen van een besturingselement voor de lijstweergave in.
CListCtrl::SetGroupInfo	Hiermee stelt u de informatie in voor de opgegeven groep van een besturingselement voor de lijstweergave.
CListCtrl::SetGroupMetrics	Hiermee stelt u de metrische groepsgegevens van een besturingselement voor de lijstweergave in.
CListCtrl::SetHotCursor	Hiermee stelt u de cursor in die wordt gebruikt wanneer dynamisch bijhouden is ingeschakeld voor een besturingselement voor de lijstweergave.
CListCtrl::SetHotItem	Hiermee stelt u het huidige dynamische item van een besturingselement voor de lijstweergave in.
CListCtrl::SetHoverTime	Hiermee stelt u de huidige aanwijstijd van een besturingselement voor de lijstweergave in.
CListCtrl::SetIconSpacing	Hiermee stelt u de afstand tussen pictogrammen in een besturingselement voor de lijstweergave in.
CListCtrl::SetImageList	Hiermee wijst u een lijst met afbeeldingen toe aan een besturingselement voor de lijstweergave.
CListCtrl::SetInfoTip	Hiermee stelt u de knopinfotekst in.
CListCtrl::SetInsertMark	Hiermee stelt u de invoegpositie in op de gedefinieerde positie.
CListCtrl::SetInsertMarkColor	Hiermee stelt u de kleur van de invoegpositie in.
CListCtrl::SetItem	Hiermee stelt u enkele of alle kenmerken van een lijstweergave-item in.
CListCtrl::SetItemCount	Hiermee bereidt u een besturingselement voor de lijstweergave voor het toevoegen van een groot aantal items.
CListCtrl::SetItemCountEx	Hiermee stelt u het aantal items voor een besturingselement voor een virtuele lijstweergave in.
CListCtrl::SetItemData	Hiermee stelt u de toepassingsspecifieke waarde van het item in.
CListCtrl::SetItemIndexState	Hiermee stelt u de status van een item in het huidige besturingselement voor de lijstweergave in.
CListCtrl::SetItemPosition	Hiermee verplaatst u een item naar een opgegeven positie in een besturingselement voor de lijstweergave.
CListCtrl::SetItemState	Hiermee wijzigt u de status van een item in een besturingselement voor de lijstweergave.
CListCtrl::SetItemText	Hiermee wijzigt u de tekst van een lijstweergave-item of subitem.
CListCtrl::SetOutlineColor	Hiermee stelt u de kleur van de rand van een besturingselement voor de lijstweergave in.
CListCtrl::SetSelectedColumn	Hiermee stelt u de geselecteerde kolom van het besturingselement lijstweergave in.
CListCtrl::SetSelectionMark	Hiermee stelt u de selectiemarkering van een besturingselement voor de lijstweergave in.
CListCtrl::SetTextBkColor	Hiermee stelt u de achtergrondkleur van tekst in een besturingselement voor de lijstweergave in.
CListCtrl::SetTextColor	Hiermee stelt u de tekstkleur van een besturingselement voor de lijstweergave in.
CListCtrl::SetTileInfo	Hiermee stelt u de informatie in voor een tegel van het besturingselement lijstweergave.
CListCtrl::SetTileViewInfo	Hiermee stelt u informatie in die een besturingselement voor de lijstweergave gebruikt in de tegelweergave.
CListCtrl::SetToolTips	Hiermee stelt u het besturingselement voor knopinfo in dat door het besturingselement voor de lijstweergave wordt gebruikt om knopinfo weer te geven.
CListCtrl::SetView	Hiermee stelt u de weergave van het besturingselement voor de lijstweergave in.
CListCtrl::SetWorkAreas	Hiermee stelt u het gebied in waar pictogrammen kunnen worden weergegeven in een besturingselement voor de lijstweergave.
CListCtrl::SortGroups	Hiermee sorteert u de groepen van een besturingselement voor lijstweergaven met een door de gebruiker gedefinieerde functie.
CListCtrl::SortItems	Hiermee sorteert u lijstweergave-items met behulp van een door de toepassing gedefinieerde vergelijkingsfunctie.
CListCtrl::SortItemsEx	Hiermee sorteert u lijstweergave-items met behulp van een door de toepassing gedefinieerde vergelijkingsfunctie.
CListCtrl::SubItemHitTest	Bepaalt welk lijstweergave-item, indien aanwezig, zich op een bepaalde positie bevindt.
CListCtrl::Update	Hiermee dwingt u het besturingselement om een opgegeven item opnieuw te gebruiken.

Opmerkingen

Naast een pictogram en label kan voor elk item informatie worden weergegeven in kolommen rechts van het pictogram en label. Dit besturingselement (en daarom de CListCtrl klasse) is alleen beschikbaar voor programma's die worden uitgevoerd onder Windows 95/98 en Windows NT versie 3.51 en hoger.

Hier volgt een kort overzicht van de CListCtrl klas. Zie Using CListCtrl and Controls voor een gedetailleerde, conceptuele discussie.

Weergaven

Besturingselementen voor lijstweergaven kunnen hun inhoud op vier verschillende manieren weergeven, 'weergaven' genoemd.

• Pictogramweergave

  Elk item wordt weergegeven als een pictogram van volledige grootte (32 x 32 pixels) met een label eronder. De gebruiker kan de items naar elke locatie in het lijstweergavevenster slepen.

• Kleine pictogramweergave

  Elk item wordt weergegeven als een klein pictogram (16 x 16 pixels) met het label rechts van het item. De gebruiker kan de items naar elke locatie in het lijstweergavevenster slepen.

• Lijstweergave

  Elk item wordt weergegeven als een klein pictogram met een label rechts van het item. Items worden gerangschikt in kolommen en kunnen niet naar een locatie in het lijstweergavevenster worden gesleept.

• Rapportweergave

  Elk item wordt op een eigen regel weergegeven, met aanvullende informatie gerangschikt in kolommen aan de rechterkant. De meest linkse kolom bevat het kleine pictogram en label en de volgende kolommen bevatten subitems zoals opgegeven door de toepassing. Met een ingesloten headerbesturingselement (klasse CHeaderCtrl) worden deze kolommen geïmplementeerd. Zie Using CListCtrl: Adding Columns to the Control (Rapportweergave) voor meer informatie over het besturingselement voor kopteksten en kolommen in een rapportweergave.

De stijl van de huidige lijstweergave van het besturingselement bepaalt de huidige weergave. Zie Using CListCtrl: Changing List Control Styles (Stijlen voor lijstbeheer wijzigen) voor meer informatie over deze stijlen en het bijbehorende gebruik.

Uitgebreide stijlen

Naast de standaardlijststijlen biedt klasse CListCtrl ondersteuning voor een grote set uitgebreide stijlen, die uitgebreide functionaliteit bieden. Enkele voorbeelden van deze functionaliteit zijn:

• Selectie aanwijzen

  Wanneer deze optie is ingeschakeld, kunt u automatisch een item selecteren wanneer de cursor gedurende een bepaalde periode over het item blijft.

• Weergaven van virtuele lijsten

  Als dit is ingeschakeld, kan het besturingselement maximaal DWORD-items ondersteunen. Dit is mogelijk door de overhead van het beheren van itemgegevens in de toepassing te plaatsen. Met uitzondering van de itemselectie en focusgegevens moeten alle itemgegevens worden beheerd door de toepassing. Zie Using CListCtrl: Virtual List Controls (Virtuele lijstbesturingselementen) voor meer informatie.

• Activering met één en twee klikken

  Wanneer deze optie is ingeschakeld, kunt u dynamisch bijhouden (automatisch markeren van de itemtekst) en een of twee klikken op activering van het gemarkeerde item.

• Volgorde van slepen en neerzetten van kolommen

  Wanneer deze optie is ingeschakeld, kunt u de volgorde van kolommen in een besturingselement voor de lijstweergave wijzigen. Alleen beschikbaar in de rapportweergave.

Zie Using CListCtrl: Changing List Control Styles (Stijlen voor lijstbeheer wijzigen) voor meer informatie over het gebruik van deze nieuwe uitgebreide stijlen.

Items en subitems

Elk item in een besturingselement voor de lijstweergave bestaat uit een pictogram (uit een lijst met afbeeldingen), een label, een huidige status en een door de toepassing gedefinieerde waarde (aangeduid als 'itemgegevens'). Een of meer subitems kunnen ook aan elk item worden gekoppeld. Een subitem is een tekenreeks die in de rapportweergave kan worden weergegeven in een kolom rechts van het pictogram en label van een item. Alle items in een besturingselement voor lijstweergaven moeten hetzelfde aantal subitems hebben.

Klasse CListCtrl biedt verschillende functies voor het invoegen, verwijderen, zoeken en wijzigen van deze items. Zie , CListCtrl::InsertItemen CListCtrl::FindItem, Items toevoegen aan het besturingselement en schuiven, rangschikken, sorteren en zoeken in lijstbesturingselementen voor meer informatieCListCtrl::GetItem.

Standaard is het besturingselement lijstweergave verantwoordelijk voor het opslaan van het pictogram en de tekstkenmerken van een item. Naast deze itemtypen biedt klasse CListCtrl echter ook ondersteuning voor 'callback-items'. Een callback-item is een lijstweergave-item waarvoor de toepassing, in plaats van het besturingselement, de tekst, het pictogram of beide opslaat. Er wordt een callbackmasker gebruikt om op te geven welke itemkenmerken (tekst en/of pictogram) door de toepassing worden geleverd. Als een toepassing callback-items gebruikt, moet deze de tekst- en/of pictogramkenmerken op aanvraag kunnen opgeven. Callback-items zijn handig wanneer uw toepassing al enkele van deze informatie onderhoudt. Zie Voor meer informatie : CListCtrlCallback-items en het callbackmasker.

Afbeeldingslijsten

De pictogrammen, afbeeldingen van koptekstitems en toepassingsgedefinieerde statussen voor lijstweergave-items zijn opgenomen in verschillende afbeeldingslijsten (geïmplementeerd per klasse CImageList), die u maakt en toewijst aan het besturingselement voor de lijstweergave. Elk besturingselement voor lijstweergaven kan maximaal vier verschillende typen afbeeldingslijsten hebben:

• Groot pictogram

  Wordt gebruikt in de pictogramweergave voor pictogrammen op volledige grootte.

• Klein pictogram

  Wordt gebruikt in de weergaven voor kleine pictogrammen, lijsten en rapporten voor kleinere versies van de pictogrammen die in de pictogramweergave worden gebruikt.

• Toepassingsgedefinieerde status

  Bevat statusafbeeldingen, die naast het pictogram van een item worden weergegeven om een door de toepassing gedefinieerde status aan te geven.

• Koptekstitem

  Wordt gebruikt in de rapportweergave voor kleine afbeeldingen die worden weergegeven in elk besturingselementitem voor kopteksten.

Standaard vernietigt een besturingselement voor lijstweergave de afbeeldingslijsten die eraan zijn toegewezen wanneer het wordt vernietigd; De ontwikkelaar kan dit gedrag echter aanpassen door elke lijst met installatiekopieën te vernietigen wanneer deze niet meer wordt gebruikt, zoals bepaald door de toepassing. Zie Voor meer informatie : CListCtrlLijstitems en afbeeldingslijsten gebruiken.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CListCtrl

Requirements

Rubriek:afxcmn.h

CListCtrl::ApproximateViewRect

Bepaalt de breedte en hoogte die vereist zijn om de items van een besturingselement voor de lijstweergave weer te geven.

CSize ApproximateViewRect(
    CSize sz = CSize(-1, -1),
    int iCount = -1) const;

Parameterwaarden

sz
De voorgestelde afmetingen van het besturingselement, in pixels. Als er geen dimensies zijn opgegeven, gebruikt het framework de huidige breedte- of hoogtewaarden van het besturingselement.

iCount
Het aantal items dat moet worden weergegeven in het besturingselement. Geef -1 door om het totale aantal items in het besturingselement te gebruiken.

Retourwaarde

Een CSize object dat de geschatte breedte en hoogte bevat die nodig is om de items in pixels weer te geven.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_ApproximateViewRectzoals beschreven in de Windows SDK.

CListCtrl::Arrange

Items in een pictogramweergave verplaatsen, zodat ze in een raster worden uitgelijnd.

BOOL Arrange(UINT nCode);

Parameterwaarden

nCode
Hiermee geeft u de uitlijningsstijl voor de items op. Dit kan een van de volgende waarden zijn:

• LVA_ALIGNLEFT Hiermee worden items langs de linkerrand van het venster uitgelijnd.
• LVA_ALIGNTOP Hiermee worden items langs de bovenrand van het venster uitgelijnd.
• LVA_DEFAULT Hiermee worden items uitgelijnd op basis van de huidige uitlijningsstijlen van de lijstweergave (de standaardwaarde).
• LVA_SNAPTOGRID Hiermee worden alle pictogrammen uitgelijnd op de dichtstbijzijnde rasterpositie.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De nCode parameter geeft de uitlijningsstijl aan.

Example

// Align all of the list view control items along the top
// of the window (the list view control must be in icon or
// small icon mode).
m_myListCtrl.Arrange(LVA_ALIGNTOP);

CListCtrl::CancelEditLabel

Hiermee annuleert u de bewerking voor het bewerken van itemteksten.

void CancelEditLabel();

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_CANCELEDITLABEL bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::CListCtrl

Maakt een CListCtrl object.

CListCtrl();

CListCtrl::Create

Hiermee maakt u een lijst besturingselement en koppelt u dit aan een CListCtrl object.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

dwStyle
Hiermee geeft u de stijl van het besturingselement voor de lijst. Pas een combinatie van lijstbesturingsstijlen toe op het besturingselement. Zie Vensterstijlen voor lijstweergave in de Windows SDK voor een volledige lijst met deze stijlen. Uitgebreide stijlen instellen die specifiek zijn voor een besturingselement met behulp van SetExtendedStyle.

rect
Hiermee geeft u de grootte en positie van het lijst besturingselement. Het kan een CRect object of een RECT structuur zijn.

pParentWnd
Hiermee geeft u het bovenliggende venster van het lijst besturingselement, meestal een CDialog. Deze mag niet NULL zijn.

nID
Hiermee geeft u de id van het lijstbeheer.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

U maakt een CListCtrl in twee stappen. Roep eerst de constructor aan en roep Createvervolgens het besturingselement voor de lijstweergave aan en koppel deze aan het CListCtrl object.

Als u uitgebreide Windows-stijlen wilt toepassen op het object voor lijstbeheer, roept CreateEx u aan in plaats van Create.

Example

m_myListCtrl.Create(
    WS_CHILD|WS_VISIBLE|WS_BORDER|LVS_REPORT|LVS_EDITLABELS,
    CRect(10,10,400,200), pParentWnd, IDD_MYLISTCTRL);

CListCtrl::CreateEx

Hiermee maakt u een besturingselement (een onderliggend venster) en koppelt u dit aan het CListCtrl object.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

dwExStyle
Hiermee geeft u de uitgebreide stijl van het besturingselement dat wordt gemaakt. Zie de dwExStyle-parameter voor CreateWindowEx een lijst met uitgebreide Windows-stijlen in de Windows SDK.

dwStyle
Hiermee geeft u de stijl van het besturingselement voor de lijst. Pas een combinatie van lijstbesturingsstijlen toe op het besturingselement. Zie Lijstweergavevensterstijlen in de Windows SDK voor een volledige lijst met deze stijlen.

rect
Een verwijzing naar een RECT structuur die de grootte en positie van het venster beschrijft dat moet worden gemaakt, in clientcoördinaten van pParentWnd.

pParentWnd
Een aanwijzer naar het venster dat het bovenliggende besturingselement is.

nID
De id van het onderliggende venster van het besturingselement.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Gebruik CreateEx in plaats van Create uitgebreide Windows-stijlen toe te passen, die zijn opgegeven door het voorwoord WS_EX_voor de uitgebreide Stijl van Windows.

CreateEx maakt het besturingselement met de uitgebreide Windows-stijlen die zijn opgegeven door dwExStyle. Als u uitgebreide stijlen wilt instellen die specifiek zijn voor een besturingselement, roept u aan SetExtendedStyle. U kunt CreateEx bijvoorbeeld stijlen zoals WS_EX_CONTEXTHELP instellen, maar deze gebruiken SetExtendedStyle om stijlen zoals LVS_EX_FULLROWSELECT in te stellen. Zie de stijlen die worden beschreven in het artikel Uitgebreide lijstweergavestijlen in de Windows SDK voor meer informatie.

CListCtrl::CreateDragImage

Hiermee maakt u een lijst met sleepafbeeldingen voor het item dat is opgegeven door nItem.

CImageList* CreateDragImage(
    int nItem,
    LPPOINT lpPoint);

Parameterwaarden

nItem
Index van het item waarvan de lijst met sleepafbeeldingen moet worden gemaakt.

lpPoint
Adres van een POINT structuur die de eerste locatie van de linkerbovenhoek van de afbeelding ontvangt, in weergavecoördinaten.

Retourwaarde

Een aanwijzer naar de lijst met sleepafbeeldingen indien geslaagd; anders NULL.

Opmerkingen

Het CImageList object is permanent en u moet het verwijderen wanneer u klaar bent. Voorbeeld:

CImageList* pImageList = m_myListCtrl.CreateDragImage(nItem, &point);

// do something

delete pImageList;

CListCtrl::DeleteAllItems

Hiermee verwijdert u alle items uit het besturingselement lijstweergave.

BOOL DeleteAllItems();

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

// Delete all of the items from the list view control.
m_myListCtrl.DeleteAllItems();
ASSERT(m_myListCtrl.GetItemCount() == 0);

CListCtrl::DeleteColumn

Hiermee verwijdert u een kolom uit het besturingselement lijstweergave.

BOOL DeleteColumn(int nCol);

Parameterwaarden

nCol
Index van de kolom die moet worden verwijderd.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

int nColumnCount = m_myListCtrl.GetHeaderCtrl()->GetItemCount();

// Delete all of the columns.
for (int i=0; i < nColumnCount; i++)
{
    m_myListCtrl.DeleteColumn(0);
}

CListCtrl::DeleteItem

Hiermee verwijdert u een item uit een besturingselement voor de lijstweergave.

BOOL DeleteItem(int nItem);

Parameterwaarden

nItem
Hiermee geeft u de index van het item dat moet worden verwijderd.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

int nCount = m_myListCtrl.GetItemCount();

// Delete all of the items from the list view control.
for (int i=0; i < nCount; i++)
{
    m_myListCtrl.DeleteItem(0);
}

CListCtrl::DrawItem

Aangeroepen door het framework wanneer een visueel aspect van een lijstweergave met eigenaartekening verandert.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parameterwaarden

lpDrawItemStruct
Een lange aanwijzer naar een DRAWITEMSTRUCT structuur die informatie bevat over het type tekening dat nodig is.

Opmerkingen

Het itemAction lid van de DRAWITEMSTRUCT structuur definieert de tekenactie die moet worden uitgevoerd.

Deze lidfunctie doet standaard niets. Overschrijf deze lidfunctie om tekening te implementeren voor een eigenaar-tekenobject CListCtrl .

De toepassing moet alle GDI-objecten (Graphics Device Interface) herstellen die zijn geselecteerd voor de weergavecontext die is opgegeven lpDrawItemStruct voordat deze lidfunctie wordt beëindigd.

CListCtrl::EditLabel

Begint met het in-place bewerken van de tekst van een item.

CEdit* EditLabel(int nItem);

Parameterwaarden

nItem
Index van het lijstweergave-item dat moet worden bewerkt.

Retourwaarde

Als dit lukt, wijst u een aanwijzer naar het CEdit object dat wordt gebruikt om de itemtekst te bewerken; anders NULL.

Opmerkingen

Met een besturingselement voor lijstweergaven met de LVS_EDITLABELS vensterstijl kan een gebruiker itemlabels bewerken. De gebruiker begint met bewerken door te klikken op het label van een item met de focus.

Gebruik deze functie om te beginnen met het bewerken van de tekst van het opgegeven lijstweergave-item.

Example

// Make sure the focus is set to the list view control.
m_myListCtrl.SetFocus();

// Show the edit control on the label of the first
// item in the list view control.
CEdit* pmyEdit = m_myListCtrl.EditLabel(1);
ASSERT(pmyEdit != NULL);

CListCtrl::EnableGroupView

Hiermee schakelt u in of uit of de items in een besturingselement voor de lijstweergave als groep worden weergegeven.

LRESULT EnableGroupView(BOOL fEnable);

Parameterwaarden

fEnable
Hiermee wordt aangegeven of een besturingselement listview moet worden ingeschakeld om weergegeven items te groeperen. TRUE groepering in te schakelen; FALSE om deze uit te schakelen.

Retourwaarde

Retourneert een van de volgende waarden:

• 0 De mogelijkheid om lijstweergave-items weer te geven als een groep is al ingeschakeld of uitgeschakeld.
• 1 De status van het besturingselement is gewijzigd.
• -1 De bewerking is mislukt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_ENABLEGROUPVIEW bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::EnsureVisible

Zorgt ervoor dat een item in de lijstweergave ten minste gedeeltelijk zichtbaar is.

BOOL EnsureVisible(
    int nItem,
    BOOL bPartialOK);

Parameterwaarden

nItem
Index van het lijstweergave-item dat zichtbaar moet zijn.

bPartialOK
Hiermee geeft u op of gedeeltelijke zichtbaarheid acceptabel is.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Het besturingselement lijstweergave wordt zo nodig geschoven. Als de parameter bPartialOK niet-nul is, wordt er geen schuifbewerking uitgevoerd als het item gedeeltelijk zichtbaar is.

Example

// Ensure that the last item is visible.
int nCount = m_myListCtrl.GetItemCount();
if (nCount > 0)
    m_myListCtrl.EnsureVisible(nCount-1, FALSE);

CListCtrl::FindItem

Hiermee wordt gezocht naar een lijstweergave-item met opgegeven kenmerken.

int FindItem(
    LVFINDINFO* pFindInfo,
    int nStart = -1) const;

Parameterwaarden

pFindInfo
Een aanwijzer naar een LVFINDINFO structuur met informatie over het item dat moet worden gezocht.

nStart
Index van het item waarmee u de zoekopdracht wilt starten of -1 om vanaf het begin te beginnen. Het item op nStart is uitgesloten van de zoekopdracht als nStart dit niet gelijk is aan -1.

Retourwaarde

De index van het item als dit lukt of anders -1.

Opmerkingen

De pFindInfo parameter verwijst naar een LVFINDINFO structuur, die informatie bevat die wordt gebruikt voor het zoeken naar een lijstweergave-item.

Example

LVFINDINFO info;
int nIndex;

info.flags = LVFI_PARTIAL|LVFI_STRING;
info.psz = _T("item");

// Delete all of the items that begin with the string.
while ((nIndex = m_myListCtrl.FindItem(&info)) != -1)
{
    m_myListCtrl.DeleteItem(nIndex);
}

CListCtrl::GetBkColor

Hiermee haalt u de achtergrondkleur van een besturingselement voor de lijstweergave op.

COLORREF GetBkColor() const;

Retourwaarde

Een 32-bits waarde die wordt gebruikt om een RGB-kleur op te geven.

Example

Zie het voorbeeld voor CListCtrl::SetBkColor.

CListCtrl::GetBkImage

Hiermee haalt u de huidige achtergrondafbeelding van een besturingselement voor de lijstweergave op.

BOOL GetBkImage(LVBKIMAGE* plvbkImage) const;

Parameterwaarden

plvbkImage
Een aanwijzer naar een LVBKIMAGE structuur met de huidige achtergrondafbeelding van de lijstweergave.

Retourwaarde

Retourneert niet-nul als dit lukt of anders nul.

Opmerkingen

Met deze methode wordt het gedrag van de Win32-macro geïmplementeerd, ListView_GetBkImagezoals beschreven in de Windows SDK.

Example

LVBKIMAGE bki;

// If no background image is set for the list view control use
// the Microsoft homepage image as the background image.
if (m_myListCtrl.GetBkImage(&bki) && (bki.ulFlags == LVBKIF_SOURCE_NONE))
{
    m_myListCtrl.SetBkImage(
        _T("https://www.microsoft.com/library/images/gifs/homepage/microsoft.gif"),
        TRUE);
}

CListCtrl::GetCallbackMask

Hiermee haalt u het callbackmasker voor een besturingselement voor de lijstweergave op.

UINT GetCallbackMask() const;

Retourwaarde

Het callbackmasker van het besturingselement voor de lijstweergave.

Opmerkingen

Een callback-item is een lijstweergave-item waarvoor de toepassing, in plaats van het besturingselement, de tekst, het pictogram of beide opslaat. Hoewel een besturingselement voor de lijstweergave deze kenmerken voor u kan opslaan, kunt u callback-items gebruiken als uw toepassing al een deel van deze informatie onderhoudt. Het callback-masker geeft aan welke itemstatus-bits worden onderhouden door de toepassing en is van toepassing op het hele besturingselement in plaats van op een specifiek item. Het callbackmasker is standaard nul, wat betekent dat het besturingselement alle itemstatussen bijhoudt. Als een toepassing callback-items gebruikt of een niet-nul-callbackmasker opgeeft, moet deze de kenmerken van lijstweergaveitems op aanvraag kunnen leveren.

Example

Zie het voorbeeld voor CListCtrl::SetCallbackMask.

CListCtrl::GetCheck

Hiermee wordt de huidige weergavestatus opgehaald van de statusafbeelding die is gekoppeld aan een item.

BOOL GetCheck(int nItem) const;

Parameterwaarden

nItem
De op nul gebaseerde index van een lijstbesturingselementitem.

Retourwaarde

Niet-nul als het item is geselecteerd, anders 0.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetCheckStatezoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::SetCheck.

CListCtrl::GetColumn

Hiermee worden de kenmerken van de kolom van een lijstweergavebeheer opgehaald.

BOOL GetColumn(
    int nCol,
    LVCOLUMN* pColumn) const;

Parameterwaarden

nCol
Index van de kolom waarvan de kenmerken moeten worden opgehaald.

pColumn
Adres van een LVCOLUMN structuur die de informatie opgeeft die moet worden opgehaald en ontvangen over de kolom. Het mask lid geeft aan welke kolomkenmerken moeten worden opgehaald. Als het mask lid de LVCF_TEXT waarde opgeeft, moet het pszText lid het adres van de buffer bevatten dat de itemtekst ontvangt en moet het cchTextMax lid de grootte van de buffer opgeven.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De LVCOLUMN structuur bevat informatie over een kolom in de rapportweergave.

Example

LVCOLUMN col;

col.mask = LVCF_WIDTH;

// Double the column width of the first column.
if (m_myListCtrl.GetColumn(0, &col))
{
    col.cx *= 2;
    m_myListCtrl.SetColumn(0, &col);
}

CListCtrl::GetColumnOrderArray

Hiermee haalt u de kolomvolgorde (van links naar rechts) van een besturingselement voor de lijstweergave op.

BOOL GetColumnOrderArray(
    LPINT piArray,
    int iCount = -1);

Parameterwaarden

piArray
Een aanwijzer naar een buffer die de indexwaarden van de kolommen in het besturingselement lijstweergave bevat. De buffer moet groot genoeg zijn om het totale aantal kolommen in het besturingselement lijstweergave te bevatten.

iCount
Aantal kolommen in het besturingselement lijstweergave. Als deze parameter -1 is, wordt het aantal kolommen automatisch opgehaald door het framework.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetColumnOrderArrayzoals beschreven in de Windows SDK.

Example

// Reverse the order of the columns in the list view control
// (i.e. make the first column the last, the last column
// the first, and so on...).
CHeaderCtrl* pHeaderCtrl = m_myListCtrl.GetHeaderCtrl();

if (pHeaderCtrl != NULL)
{
    int  nColumnCount = pHeaderCtrl->GetItemCount();
    LPINT pnOrder = (LPINT) malloc(nColumnCount*sizeof(int));
    ASSERT(pnOrder != NULL);
    m_myListCtrl.GetColumnOrderArray(pnOrder, nColumnCount);

    int i, j, nTemp;
    for (i = 0, j = nColumnCount-1; i < j; i++, j--)
    {
        nTemp = pnOrder[i];
        pnOrder[i] = pnOrder[j];
        pnOrder[j] = nTemp;
    }

    m_myListCtrl.SetColumnOrderArray(nColumnCount, pnOrder);
    free(pnOrder);
}

CListCtrl::GetColumnWidth

Hiermee haalt u de breedte van een kolom in de rapportweergave of lijstweergave op.

int GetColumnWidth(int nCol) const;

Parameterwaarden

nCol
Hiermee geeft u de index van de kolom waarvan de breedte moet worden opgehaald.

Retourwaarde

De breedte, in pixels, van de kolom die is opgegeven door nCol.

Example

// Increase the column width of the second column by 20.
int nWidth = m_myListCtrl.GetColumnWidth(1);
m_myListCtrl.SetColumnWidth(1, 20 + nWidth);

CListCtrl::GetCountPerPage

Berekent het aantal items dat verticaal in het zichtbare gebied van een lijstweergave besturingselement past wanneer deze zich in de lijstweergave of rapportweergave bevindt.

int GetCountPerPage() const;

Retourwaarde

Het aantal items dat verticaal in het zichtbare gebied van een besturingselement voor een lijstweergave past wanneer dit in de lijstweergave of rapportweergave past.

Example

Zie het voorbeeld voor CListCtrl::GetTopIndex.

CListCtrl::GetEditControl

Hiermee wordt de greep opgehaald van het besturingselement bewerken dat wordt gebruikt om de tekst van een lijstweergave-item te bewerken.

CEdit* GetEditControl() const;

Retourwaarde

Als dit lukt, wijst u een aanwijzer naar het CEdit object dat wordt gebruikt om de itemtekst te bewerken; anders NULL.

Example

// The string replacing the text in the edit control.
LPCTSTR lpszmyString = _T("custom label!");

// If possible, replace the text in the label edit control.
CEdit* pEdit = m_myListCtrl.GetEditControl();

if (pEdit != NULL)
{
    pEdit->SetWindowText(lpszmyString);
}

CListCtrl::GetEmptyText

Hiermee wordt de tekenreeks opgehaald die moet worden weergegeven als het huidige besturingselement voor de lijstweergave leeg is.

CString GetEmptyText() const;

Retourwaarde

Een CString met de tekst die moet worden weergegeven als het besturingselement leeg is.

Opmerkingen

Met deze methode wordt het LVM_GETEMPTYTEXT bericht verzonden, dat wordt beschreven in de Windows SDK.

CListCtrl::GetExtendedStyle

Hiermee haalt u de huidige uitgebreide stijlen van een besturingselement voor de lijstweergave op.

DWORD GetExtendedStyle();

Retourwaarde

Een combinatie van de uitgebreide stijlen die momenteel worden gebruikt door het besturingselement lijstweergave. Zie het artikel Uitgebreide lijstweergavestijlen in de Windows SDK voor een beschrijvende lijst met deze uitgebreide stijlen.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetExtendedListViewStylezoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::SetExtendedStyle.

CListCtrl::GetFirstSelectedItemPosition

Hiermee haalt u de positie op van het eerste geselecteerde item in het besturingselement lijstweergave.

POSITION GetFirstSelectedItemPosition() const;

Retourwaarde

Een POSITION waarde die kan worden gebruikt voor het ophalen van iteratie of objectaanwijzer. NULL Als er geen items zijn geselecteerd.

Example

In het volgende codevoorbeeld ziet u het gebruik van deze functie.

POSITION pos = m_myListCtrl.GetFirstSelectedItemPosition();
if (pos == NULL)
{
    TRACE(_T("No items were selected!\n"));
}
else
{
    while (pos)
    {
        int nItem = m_myListCtrl.GetNextSelectedItem(pos);
        TRACE(_T("Item %d was selected!\n"), nItem);
        // you could do your own processing on nItem here
    }
}

CListCtrl::GetFocusedGroup

Haalt de groep met de toetsenbordfocus op in het huidige besturingselement voor lijstweergave.

int GetFocusedGroup() const;

Retourwaarde

De index van de groep waarvan de status is LVGS_FOCUSED, als er een dergelijke groep is; anders -1.

Opmerkingen

Met deze methode wordt het LVM_GETFOCUSEDGROUP bericht verzonden, dat wordt beschreven in de Windows SDK. Zie de LVGS_FOCUSED waarde van het state lid van de LVGROUP structuur voor meer informatie.

CListCtrl::GetGroupCount

Hiermee haalt u het aantal groepen op in het huidige besturingselement voor de lijstweergave.

int GetGroupCount()const;

Retourwaarde

Het aantal groepen in het besturingselement lijstweergave.

Opmerkingen

Met deze methode wordt het LVM_GETGROUPCOUNT bericht verzonden, dat wordt beschreven in de Windows SDK -->.

CListCtrl::GetGroupInfo

Hiermee haalt u de informatie op voor een opgegeven groep van het besturingselement lijstweergave.

int GetGroupInfo(
    int iGroupId,
    PLVGROUP pgrp) const;

Parameterwaarden

iGroupId
De id van de groep waarvan de gegevens moeten worden opgehaald.

pgrp
Een aanwijzer naar de LVGROUP informatie over de opgegeven groep.

Retourwaarde

Retourneert de id van de groep als deze is geslaagd of -1 anders.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETGROUPINFO bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetGroupInfoByIndex

Hiermee wordt informatie opgehaald over een opgegeven groep in het huidige besturingselement voor de lijstweergave.

BOOL GetGroupInfoByIndex(
    int iIndex,
    PLVGROUP pGroup) const;

Parameterwaarden

iIndex
[in] Op nul gebaseerde index van een groep.

pGroup
[uit] Wijs een LVGROUP-structuur aan die informatie ontvangt over de groep die is opgegeven door de parameter iIndex . De beller is verantwoordelijk voor het initialiseren van de leden van de LVGROUP-structuur . Stel het cbSize lid in op de grootte van de structuur en de vlaggen van het mask lid om de informatie op te geven die moet worden opgehaald.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het LVM_GETGROUPINFOBYINDEX bericht verzonden, dat wordt beschreven in de Windows SDK -->.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_listCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor lijstweergave. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

In het volgende codevoorbeeld ziet u de GetGroupInfoByIndex methode. In een eerdere sectie van dit codevoorbeeld hebben we een besturingselement voor lijstweergave gemaakt waarin twee kolommen met de titel 'ClientID' en 'Grade' in een rapportweergave worden weergegeven. In het volgende codevoorbeeld wordt informatie opgehaald over de groep waarvan de index 0 is, als een dergelijke groep bestaat.

// GetGroupInfoByIndex
const int GROUP_HEADER_BUFFER_SIZE = 40;

// Initialize the structure
LVGROUP gInfo = {0};
gInfo.cbSize = sizeof(LVGROUP);
wchar_t wstrHeadGet[GROUP_HEADER_BUFFER_SIZE] = {0};
gInfo.cchHeader = GROUP_HEADER_BUFFER_SIZE;
gInfo.pszHeader = wstrHeadGet;
gInfo.mask = (LVGF_ALIGN | LVGF_STATE | LVGF_HEADER | LVGF_GROUPID);
gInfo.state = LVGS_NORMAL;
gInfo.uAlign  = LVGA_HEADER_LEFT;

BOOL bRet = m_listCtrl.GetGroupInfoByIndex( 0, &gInfo );
if (bRet == TRUE) {
    CString strHeader = CString( gInfo.pszHeader );
    CString str;
    str.Format(_T("Header: '%s'"), strHeader);
    AfxMessageBox(str, MB_ICONINFORMATION);
}
else
{
    AfxMessageBox(_T("No group information was retrieved."));
}

CListCtrl::GetGroupMetrics

Haalt de metrische gegevens van een groep op.

void GetGroupMetrics(PLVGROUPMETRICS pGroupMetrics) const;

Parameterwaarden

pGroupMetrics
Een aanwijzer naar een LVGROUPMETRICS met de metrische gegevens van de groep.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETGROUPMETRICS bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetGroupRect

Hiermee haalt u de begrenzingsrechthoek voor een opgegeven groep op in het huidige besturingselement voor lijstweergave.

BOOL GetGroupRect(
    int iGroupId,
    LPRECT lpRect,
    int iCoords = LVGGR_GROUP) const;

Parameterwaarden

iGroupId
[in] Hiermee geeft u een groep.

lpRect
[in, uit] Wijs een RECT structuur aan. Als deze methode is geslaagd, ontvangt de structuur de rechthoekcoördinaten van de groep die is opgegeven door iGroupId.

iCoords
[in] Hiermee geeft u de rechthoekcoördinaten op die moeten worden opgehaald. Gebruik een van deze waarden:

• LVGGR_GROUP - (Standaard) Coördinaten van de hele uitgevouwen groep.
• LVGGR_HEADER - Coördinaten van alleen de koptekst (samengevouwen groep).
• LVGGR_SUBSETLINK - Coördinaten van alleen de subsetkoppeling (subset markeringen).

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

De aanroeper is verantwoordelijk voor het toewijzen van de RECT structuur die wordt verwezen door de pRect parameter.

Met deze methode wordt het LVM_GETGROUPRECT bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_listCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor lijstweergave. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

In het volgende codevoorbeeld ziet u de GetGroupRect methode. In een eerdere sectie van dit codevoorbeeld hebben we een besturingselement voor lijstweergave gemaakt waarin twee kolommen met de titel 'ClientID' en 'Grade' in een rapportweergave worden weergegeven. In het volgende codevoorbeeld wordt een 3D-rechthoek rond de groep tekend waarvan de index 0 is, als een dergelijke groep bestaat.

// GetGroupRect

// Get the graphics rectangle that surrounds group 0.
CRect rect;
BOOL bRet = m_listCtrl.GetGroupRect( 0, &rect, LVGGR_GROUP);
// Draw a blue rectangle around group 0.
if (bRet == TRUE) {
    m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(0, 0, 255), RGB(0, 0, 255));
}
else {
    AfxMessageBox(_T("No group information was retrieved."), MB_ICONINFORMATION);
}

CListCtrl::GetGroupState

Haalt de status voor een opgegeven groep op in het huidige besturingselement voor lijstweergave.

UINT GetGroupState(
    int iGroupId,
    DWORD dwMask) const;

Parameterwaarden

iGroupId
[in] Op nul gebaseerde index van een groep.

dwMask
[in] Masker waarmee de statuswaarde wordt opgegeven die moet worden opgehaald voor de opgegeven groep. Zie het mask lid van de LVGROUP structuur voor meer informatie.

Retourwaarde

De aangevraagde status voor de opgegeven groep of 0 als de groep niet kan worden gevonden.

Opmerkingen

De retourwaarde is het resultaat van een bitsgewijze AND-bewerking voor de dwMask parameter en de waarde van het state lid van een LVGROUP structuur die het huidige besturingselement voor de lijstweergave vertegenwoordigt.

Met deze methode wordt het LVM_GETGROUPSTATE bericht verzonden, dat wordt beschreven in de Windows SDK. Zie de ListView_GetGroupState macro voor meer informatie.

CListCtrl::GetHeaderCtrl

Hiermee haalt u het besturingselement koptekst van een besturingselement voor de lijstweergave op.

CHeaderCtrl* GetHeaderCtrl();

Retourwaarde

Een aanwijzer naar het besturingselement koptekst, dat wordt gebruikt door het besturingselement lijstweergave.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetHeaderzoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::GetColumnOrderArray.

CListCtrl::GetHotCursor

Hiermee haalt u de cursor op die wordt gebruikt wanneer dynamisch bijhouden is ingeschakeld voor een besturingselement voor de lijstweergave.

HCURSOR GetHotCursor();

Retourwaarde

De ingang voor de huidige hot cursor-resource die wordt gebruikt door het besturingselement lijstweergave.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetHotCursorzoals beschreven in de Windows SDK. De dynamische cursor, alleen zichtbaar wanneer de aanwijsselectie is ingeschakeld, wordt weergegeven wanneer de cursor een lijstweergave-item doorgeeft. De aanwijsselectie wordt ingeschakeld door de LVS_EX_TRACKSELECT uitgebreide stijl in te stellen.

Example

// Set the hot cursor to be the system app starting cursor.
HCURSOR hCursor = ::LoadCursor(NULL, IDC_APPSTARTING);
m_myListCtrl.SetHotCursor(hCursor);
ASSERT(m_myListCtrl.GetHotCursor() == hCursor);

CListCtrl::GetHotItem

Hiermee haalt u het lijstweergave-item op dat zich momenteel onder de cursor bevindt.

int GetHotItem();

Retourwaarde

De index van het huidige dynamische item van het besturingselement lijstweergave.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetHotItemzoals beschreven in de Windows SDK. Het dynamische item wordt gedefinieerd als het geselecteerde item wanneer dynamische tracering (en aanwijsselectie) is ingeschakeld.

Als dynamisch bijhouden is ingeschakeld, wordt het itemlabel automatisch gemarkeerd zonder een muisknop te gebruiken wanneer een gebruiker een item in de lijstweergave onderbreekt.

Example

// Set the hot item to the first item only if no other item is
// highlighted.
if (m_myListCtrl.GetHotItem() == -1)
    m_myListCtrl.SetHotItem(0);

CListCtrl::GetHoverTime

Hiermee haalt u de huidige aanwijstijd van een besturingselement voor de lijstweergave op.

DWORD GetHoverTime() const;

Retourwaarde

Retourneert de vertraging, in milliseconden, die de muisaanwijzer op een item moet plaatsen voordat het wordt geselecteerd. Als de retourwaarde -1 is, is de aanwijstijd de standaardaanwijzertijd.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetHoverTimezoals beschreven in de Windows SDK.

Example

// If the hover time is the default set to 1 sec.
DWORD dwTime = m_myListCtrl.GetHoverTime();
if (dwTime == -1)
    m_myListCtrl.SetHoverTime(1000);

CListCtrl::GetImageList

Hiermee wordt de greep opgehaald van een lijst met afbeeldingen die wordt gebruikt voor items in de lijstweergave van de tekening.

CImageList* GetImageList(int nImageList) const;

Parameterwaarden

nImageList
Waarde die aangeeft welke lijst met afbeeldingen moet worden opgehaald. Dit kan een van deze waarden zijn:

• LVSIL_NORMAL Lijst met afbeeldingen met grote pictogrammen.
• LVSIL_SMALL Lijst met afbeeldingen met kleine pictogrammen.
• LVSIL_STATE Lijst met afbeeldingen met statusafbeeldingen.

Retourwaarde

Een aanwijzer naar de lijst met afbeeldingen die wordt gebruikt voor items in de lijst met tekenlijsten.

Example

ASSERT(m_myListCtrl.GetImageList(LVSIL_NORMAL) == NULL);
m_myListCtrl.SetImageList(&m_lcImageList, LVSIL_NORMAL);
ASSERT(m_myListCtrl.GetImageList(LVSIL_NORMAL) == &m_lcImageList);

CListCtrl::GetInsertMark

Hiermee haalt u de huidige positie van de invoegmarkering op.

BOOL GetInsertMark(LPLVINSERTMARK plvim) const;

Parameterwaarden

plvim
Een aanwijzer naar een LVINSERTMARK structuur met de informatie voor de invoegmarkering.

Retourwaarde

Retourneert TRUE indien geslaagd of FALSE anderszins. FALSE wordt geretourneerd als de grootte in het cbSize lid van de LVINSERTMARK structuur niet gelijk is aan de werkelijke grootte van de structuur.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETINSERTMARK bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetInsertMarkColor

Hiermee wordt de huidige kleur van de invoegmarkering opgehaald.

COLORREF GetInsertMarkColor() const;

Retourwaarde

Retourneert een COLORREF structuur die de kleur van de invoegpositie bevat.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETINSERTMARKCOLOR bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetInsertMarkRect

Hiermee haalt u de rechthoek op die de invoegpositie begrenst.

int GetInsertMarkRect(LPRECT pRect) const;

Parameterwaarden

pRect
Wijs een RECT structuur aan die de coördinaten bevat van een rechthoek die de invoegpositie begrenst.

Retourwaarde

Retourneert een van de volgende waarden:

• 0 Geen invoegpositie gevonden.
• 1 Invoegpositie gevonden.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETINSERTMARKRECT bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetItem

Hiermee worden enkele of alle kenmerken van een lijstweergave-item opgehaald.

BOOL GetItem(LVITEM* pItem) const;

Parameterwaarden

pItem
Wijs een LVITEM structuur aan die de kenmerken van het item ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De LVITEM structuur specificeert of ontvangt de kenmerken van een lijstweergave-item.

CListCtrl::GetItemCount

Hiermee haalt u het aantal items in een besturingselement voor de lijstweergave op.

int GetItemCount() const;

Retourwaarde

Het aantal items in het besturingselement lijstweergave.

Example

Zie het voorbeeld voor CListCtrl::DeleteItem.

CListCtrl::GetItemData

Haalt de 32-bits toepassingsspecifieke waarde (64-bits) op die is gekoppeld aan het item dat is opgegeven door nItemx64.

DWORD_PTR GetItemData(int nItem) const;

Parameterwaarden

nItem
Index van het lijstitem waarvan de gegevens moeten worden opgehaald.

Retourwaarde

Een 32-bits (64-bits) toepassingsspecifieke waarde voor x64 die is gekoppeld aan het opgegeven item.

Opmerkingen

Deze waarde is het lParam lid van de LVITEM structuur, zoals beschreven in de Windows SDK

Example

// If any item's data is equal to zero then reset it to -1.
for (int i=0; i < m_myListCtrl.GetItemCount(); i++)
{
    if (m_myListCtrl.GetItemData(i) == 0)
    {
        m_myListCtrl.SetItemData(i, (DWORD) -1);
    }
}

CListCtrl::GetItemIndexRect

Hiermee wordt de begrenzingsrechthoek opgehaald voor alle of een deel van een subitem in het huidige besturingselement voor lijstweergave.

BOOL GetItemIndexRect(
    PLVITEMINDEX pItemIndex,
    int iColumn,
    int rectType,
    LPRECT pRect) const;

Parameterwaarden

pItemIndex
[in] Wijs een LVITEMINDEX structuur aan voor het bovenliggende item van de subitem. De beller is verantwoordelijk voor het toewijzen en instellen van de leden van de LVITEMINDEX structuur. Deze parameter kan niet zijn NULL.

iColumn
[in] Op nul gebaseerde index van een kolom in het besturingselement.

rectType
[in] Gedeelte van het subitem voor de lijstweergave waarvoor de begrenzingsrechthoek wordt opgehaald. Geef een van de volgende waarden op:

• LVIR_BOUNDS - Retourneert de begrenzingsrechthoek van het hele subitem, inclusief het pictogram en label.
• LVIR_ICON - Retourneert de begrenzingsrechthoek van het pictogram of kleine pictogram van de subitem.
• LVIR_LABEL - Retourneert de begrenzingsrechthoek van de subitemtekst.

pRect
[uit] Wijs een RECT structuur aan die informatie ontvangt over de begrenzingsrechthoek van het subitem. De beller is verantwoordelijk voor het toewijzen van de RECT structuur. Deze parameter kan niet zijn NULL.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het LVM_GETITEMINDEXRECT bericht verzonden, dat wordt beschreven in de Windows SDK. Zie ListView_GetItemIndexRect Macro voor meer informatie.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_listCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor lijstweergave. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

In het volgende codevoorbeeld ziet u de GetGroupRect methode. Voordat u dit codevoorbeeld invoert, hebben we een besturingselement voor lijstweergave gemaakt waarin twee kolommen met de titel 'ClientID' en 'Grade' in een rapportweergave worden weergegeven. In het volgende codevoorbeeld wordt een 3D-rechthoek rond de tweede subitem in beide kolommen tekend.

// GetItemIndexRect
// Get the rectangle that bounds the second item in the first group.
LVITEMINDEX lvItemIndex;
lvItemIndex.iGroup = 0;
lvItemIndex.iItem = 1;
CRect rect;
BOOL bRet = m_listCtrl.GetItemIndexRect(
    &lvItemIndex, 0, LVIR_BOUNDS, &rect);

// Draw a red rectangle around the item.
m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(255, 0, 0) );

CListCtrl::GetItemPosition

Hiermee haalt u de positie van een lijstweergave-item op.

BOOL GetItemPosition(
    int nItem,
    LPPOINT lpPoint) const;

Parameterwaarden

nItem
De index van het item waarvan de positie moet worden opgehaald.

lpPoint
Adres van een POINT structuur die de positie van de linkerbovenhoek van het item ontvangt, in weergavecoördinaten.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

POINT pt;

// Move all items in the list control 100 pixels to the right.
UINT i, nCount = m_myListCtrl.GetItemCount();

for (i=0; i < nCount; i++)
{
    m_myListCtrl.GetItemPosition(i, &pt);
    pt.x += 100;
    m_myListCtrl.SetItemPosition(i, pt);
}

CListCtrl::GetItemRect

Hiermee haalt u de begrenzingsrechthoek voor alle of een deel van een item in de huidige weergave op.

BOOL GetItemRect(
    int nItem,
    LPRECT lpRect,
    UINT nCode) const;

Parameterwaarden

nItem
De index van het item waarvan de positie moet worden opgehaald.

lpRect
Adres van een RECT structuur die de begrenzingsrechthoek ontvangt.

nCode
Gedeelte van het lijstweergave-item waarvoor de begrenzingsrechthoek moet worden opgehaald. Dit kan een van deze waarden zijn:

• LVIR_BOUNDS Retourneert de begrenzingsrechthoek van het hele item, inclusief het pictogram en label.
• LVIR_ICON Retourneert de begrenzingsrechthoek van het pictogram of klein pictogram.
• LVIR_LABEL Retourneert de begrenzingsrechthoek van de itemtekst.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

// OnClick is the handler for the NM_CLICK notification
void CListCtrlDlg::OnClick(NMHDR* pNMHDR, LRESULT* pResult)
{
    UNREFERENCED_PARAMETER(pResult);
    LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;

    // Get the current mouse location and convert it to client
    // coordinates.
    CPoint pos( ::GetMessagePos() );
    ScreenToClient(&pos);

    // Get indexes of the first and last visible items in
    // the listview control.
    int index = m_myListCtrl.GetTopIndex();
    int last_visible_index = index + m_myListCtrl.GetCountPerPage();
    if (last_visible_index > m_myListCtrl.GetItemCount())
        last_visible_index = m_myListCtrl.GetItemCount();

    // Loop until number visible items has been reached.
    while (index <= last_visible_index)
    {
        // Get the bounding rectangle of an item. If the mouse
        // location is within the bounding rectangle of the item,
        // you know you have found the item that was being clicked.
        CRect r;
        m_myListCtrl.GetItemRect(index, &r, LVIR_BOUNDS);
        if (r.PtInRect(pia->ptAction))
        {
            UINT flag = LVIS_SELECTED | LVIS_FOCUSED;
            m_myListCtrl.SetItemState(index, flag, flag);
            break;
        }

        // Get the next item in listview control.
        index++;
    }
}

CListCtrl::GetItemSpacing

Berekent de afstand tussen items in het huidige besturingselement voor de lijstweergave.

BOOL GetItemSpacing(
    BOOL fSmall,
    int* pnHorzSpacing,
    int* pnVertSpacing) const;

Parameterwaarden

fSmall
[in] Weergave waarvoor de itemafstand moet worden opgehaald. Geef TRUE op voor een kleine pictogramweergave of FALSE voor de pictogramweergave.

pnHorzSpacing
[uit] Bevat de horizontale afstand tussen items.

pnVertSpacing
[uit] Bevat de verticale afstand tussen items.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het LVM_GETITEMSPACING bericht verzonden, dat wordt beschreven in de Windows SDK.

CListCtrl::GetItemState

Hiermee haalt u de status van een lijstweergave-item op.

UINT GetItemState(
    int nItem,
    UINT nMask) const;

Parameterwaarden

nItem
De index van het item waarvan de status moet worden opgehaald.

nMask
Masker waarmee wordt opgegeven welke van de statusvlagmen van het item moeten worden geretourneerd.

Retourwaarde

De statusvlagmen voor het opgegeven lijstweergave-item.

Opmerkingen

De status van een item wordt opgegeven door het state lid van de LVITEM structuur, zoals beschreven in de Windows SDK. Wanneer u de status van een item opgeeft of wijzigt, geeft het stateMask lid aan welke status-bits u wilt wijzigen.

Example

Zie het voorbeeld voor CListCtrl::GetTopIndex.

CListCtrl::GetItemText

Hiermee haalt u de tekst van een lijstweergave-item of subitem op.

int GetItemText(
    int nItem,
    int nSubItem,
    LPTSTR lpszText,
    int nLen) const;

CString GetItemText(
    int nItem,
    int nSubItem) const;

Parameterwaarden

nItem
De index van het item waarvan de tekst moet worden opgehaald.

nSubItem
Hiermee geeft u de subitem waarvan de tekst moet worden opgehaald.

lpszText
Wijs een tekenreeks aan die de tekst van het item moet ontvangen.

nLen
De lengte van de buffer die wordt verwezen door lpszText.

Retourwaarde

De versie retourneert int de lengte van de opgehaalde tekenreeks.

De versie die een CString retourneert, retourneert de itemtekst.

Opmerkingen

Als nul is, wordt met deze functie het itemlabel opgehaald. Als nSubItemnSubItem dit niet nul is, wordt de tekst van de subitem opgehaald. Zie de discussie over de LVITEM structuur in de Windows SDK voor meer informatie over het subitemargument.

CListCtrl::GetNextItem

Hiermee wordt gezocht naar een lijstweergave-item met de opgegeven eigenschappen en die de opgegeven relatie met een bepaald item dragen.

int GetNextItem(
    int nItem,
    int nFlags) const;

Parameterwaarden

nItem
Index van het item waarmee u wilt beginnen met zoeken of -1 om het eerste item te vinden dat overeenkomt met de opgegeven vlaggen. Het opgegeven item zelf wordt uitgesloten van de zoekopdracht.

nFlags
Geometrische relatie van het aangevraagde item tot het opgegeven item en de status van het aangevraagde item. De geometrische relatie kan een van deze waarden zijn:

• LVNI_ABOVE Hiermee zoekt u naar een item dat zich boven het opgegeven item bevindt.
• LVNI_ALL Zoekt naar een volgend item op index (de standaardwaarde).
• LVNI_BELOW Zoekt naar een item dat zich onder het opgegeven item bevindt.
• LVNI_TOLEFT Zoekt naar een item links van het opgegeven item.
• LVNI_TORIGHT Zoekt naar een item rechts van het opgegeven item.

De status kan nul zijn of kan een of meer van deze waarden zijn:

• LVNI_DROPHILITED Voor het item is de LVIS_DROPHILITED statusvlag ingesteld.
• LVNI_FOCUSED Voor het item is de LVIS_FOCUSED statusvlag ingesteld.
• LVNI_SELECTED Voor het item is de LVIS_SELECTED statusvlag ingesteld.

Als voor een item niet alle opgegeven statusvlagmen zijn ingesteld, gaat de zoekopdracht verder met het volgende item.

Retourwaarde

De index van het volgende item als dit lukt of -1 anders.

CListCtrl::GetNextItemIndex

Haalt de index van het item op in het huidige besturingselement voor lijstweergave met een opgegeven set eigenschappen.

BOOL GetNextItemIndex(
    PLVITEMINDEX pItemIndex,
    int nFlags) const;

Parameterwaarden

pItemIndex
[in, uit] Wijs de LVITEMINDEX structuur aan waarmee het item wordt beschreven waar de zoekopdracht begint of -1 om het eerste item te vinden dat overeenkomt met de vlaggen in de parameter nFlags . Als deze methode is geslaagd, beschrijft de LVITEMINDEX structuur het item dat door de zoekopdracht is gevonden.

nFlags
[in] Een bitsgewijze combinatie (OR) van vlaggen die aangeven hoe de zoekopdracht moet worden uitgevoerd. De zoekopdracht kan afhankelijk zijn van de index, de status of het uiterlijk van het doelitem, of de fysieke positie van het doelitem ten opzichte van het item dat is opgegeven door de pItemIndex parameter. Zie de flags parameter in het LVM_GETNEXTITEMINDEX bericht voor meer informatie.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

De aanroeper is verantwoordelijk voor het toewijzen en instellen van de leden van de LVITEMINDEX structuur die door de pItemIndex parameter worden verwezen.

Met deze methode wordt het LVM_GETNEXTITEMINDEX bericht verzonden, dat wordt beschreven in de Windows SDK.

CListCtrl::GetNextSelectedItem

Hiermee haalt u de index op van het lijstitem dat is geïdentificeerd door posen wordt deze ingesteld pos op de POSITION-waarde.

int GetNextSelectedItem(POSITION& pos) const;

Parameterwaarden

pos
Een verwijzing naar een POSITION-waarde die wordt geretourneerd door een eerdere aanroep naar GetNextSelectedItem of GetFirstSelectedItemPosition. De waarde wordt bijgewerkt naar de volgende positie door deze aanroep.

Retourwaarde

De index van het lijstitem dat is geïdentificeerd door pos.

Opmerkingen

U kunt in een doorstuurlus gebruiken GetNextSelectedItem als u de initiële positie met een aanroep naar GetFirstSelectedItemPosition.

U moet ervoor zorgen dat uw POSITION waarde geldig is. Als deze ongeldig is, wordt de foutopsporingsversie van de Microsoft Foundation Class Library asserts.

Example

In het volgende codevoorbeeld ziet u het gebruik van deze functie.

POSITION pos = m_myListCtrl.GetFirstSelectedItemPosition();
if (pos == NULL)
{
    TRACE(_T("No items were selected!\n"));
}
else
{
    while (pos)
    {
        int nItem = m_myListCtrl.GetNextSelectedItem(pos);
        TRACE(_T("Item %d was selected!\n"), nItem);
        // you could do your own processing on nItem here
    }
}

CListCtrl::GetNumberOfWorkAreas

Hiermee haalt u het huidige aantal werkgebieden voor een besturingselement voor de lijstweergave op.

UINT GetNumberOfWorkAreas() const;

Retourwaarde

Niet gebruikt op dit moment.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetNumberOfWorkAreaszoals beschreven in de Windows SDK.

Example

UINT i, uCount = m_myListCtrl.GetNumberOfWorkAreas();
LPRECT lpRects = (LPRECT) malloc(uCount*sizeof(RECT));

if (lpRects != NULL)
{
    // Dump all of the work area dimensions.
    m_myListCtrl.GetWorkAreas(uCount, lpRects);

    for (i=0; i < uCount; i++)
    {
        TRACE(_T("Work area %d; left = %d, top = %d, right = %d, ")
            _T("bottom = %d\r\n"),
            i, lpRects[i].left, lpRects[i].top, lpRects[i].right,
            lpRects[i].bottom);
    }

    free(lpRects);
}
else
{
    TRACE(_T("Couldn't allocate enough memory!"));
}

CListCtrl::GetOutlineColor

Hiermee wordt de kleur van de rand van een besturingselement voor de lijstweergave opgehaald.

COLORREF GetOutlineColor() const;

Retourwaarde

Retourneert een COLORREF structuur met de omtrekkleur.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETOUTLINECOLOR bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetOrigin

Hiermee haalt u de huidige oorsprong van de weergave op voor een besturingselement voor de lijstweergave.

BOOL GetOrigin(LPPOINT lpPoint) const;

Parameterwaarden

lpPoint
Adres van een POINT structuur die de oorsprong van de weergave ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders nul. Als het besturingselement zich echter in de rapportweergave bevindt, is de retourwaarde altijd nul.

CListCtrl::GetSelectedColumn

Hiermee haalt u de index van de momenteel geselecteerde kolom in het lijstbeheer op.

UINT GetSelectedColumn() const;

Retourwaarde

De index van de geselecteerde kolom.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETSELECTEDCOLUMN bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetSelectedCount

Hiermee haalt u het aantal geselecteerde items op in het besturingselement lijstweergave.

UINT GetSelectedCount() const;

Retourwaarde

Het aantal geselecteerde items in het besturingselement lijstweergave.

Example

UINT i, uSelectedCount = m_myListCtrl.GetSelectedCount();
int  nItem = -1;

// Update all of the selected items.
if (uSelectedCount > 0)
{
    for (i=0; i < uSelectedCount; i++)
    {
        nItem = m_myListCtrl.GetNextItem(nItem, LVNI_SELECTED);
        ASSERT(nItem != -1);
        m_myListCtrl.Update(nItem);
    }
}

CListCtrl::GetSelectionMark

Hiermee haalt u de selectiemarkering van een besturingselement voor de lijstweergave op.

int GetSelectionMark();

Retourwaarde

De selectiemarkering op basis van nul of -1 als er geen selectiemarkering is.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetSelectionMarkzoals beschreven in de Windows SDK.

Example

// Set the selection mark to the first item only if no other item is
// selected.
if (m_myListCtrl.GetSelectionMark() == -1)
    m_myListCtrl.SetSelectionMark(0);

CListCtrl::GetStringWidth

Bepaalt de minimale kolombreedte die nodig is om alle tekenreeksen weer te geven.

int GetStringWidth(LPCTSTR lpsz) const;

Parameterwaarden

lpsz
Adres van een door null beëindigde tekenreeks waarvan de breedte moet worden bepaald.

Retourwaarde

De breedte, in pixels, van de tekenreeks die door lpsz.

Opmerkingen

De geretourneerde breedte houdt rekening met de huidige lettertype- en kolommarges van het besturingselement, maar niet met de breedte van een klein pictogram.

Example

CString strColumn;
int nWidth;

// Insert six columns in the list view control. Make the width of
// the column be the width of the column header plus 50%.
for (int i = 0; i < 6; i++)
{
    strColumn.Format(_T("column %d"), i);
    nWidth = 3*m_myListCtrl.GetStringWidth(strColumn)/2;
    m_myListCtrl.InsertColumn(i, strColumn, LVCFMT_LEFT, nWidth);
}

CListCtrl::GetSubItemRect

Hiermee haalt u de begrenzingsrechthoek van een item op in een besturingselement voor de lijstweergave.

BOOL GetSubItemRect(
    int iItem,
    int iSubItem,
    int nArea,
    CRect& ref);

Parameterwaarden

iItem
Index van het bovenliggende item van de subitem.

iSubItem
De op één gebaseerde index van het subitem.

nArea
Bepaalt het gedeelte van de begrenzingsrechthoek (van de subitem van de lijstweergave) die moet worden opgehaald. Het gedeelte (pictogram, label of beide) van de begrenzingsrechthoek wordt opgegeven door de bitsgewijze OR operator toe te passen op een of meer van de volgende waarden:

• LVIR_BOUNDS Retourneert de begrenzingsrechthoek van het hele item, inclusief het pictogram en label.
• LVIR_ICON Retourneert de begrenzingsrechthoek van het pictogram of klein pictogram.
• LVIR_LABEL Retourneert de begrenzingsrechthoek van het hele item, inclusief het pictogram en label. Dit is identiek aan LVIR_BOUNDS.

ref
Verwijzing naar een CRect object met de coördinaten van de begrenzingsrechthoek van de subitem.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetSubItemRectzoals beschreven in de Windows SDK.

CListCtrl::GetTextBkColor

Hiermee haalt u de achtergrondkleur van de tekst van een besturingselement voor de lijstweergave op.

COLORREF GetTextBkColor() const;

Retourwaarde

Een 32-bits waarde die wordt gebruikt om een RGB-kleur op te geven.

Example

Zie het voorbeeld voor CListCtrl::SetTextBkColor.

CListCtrl::GetTextColor

Hiermee haalt u de tekstkleur van een besturingselement voor de lijstweergave op.

COLORREF GetTextColor() const;

Retourwaarde

Een 32-bits waarde die wordt gebruikt om een RGB-kleur op te geven.

Example

Zie het voorbeeld voor CListCtrl::SetTextColor.

CListCtrl::GetTileInfo

Hiermee haalt u informatie over een tegel op in een besturingselement voor de lijstweergave.

BOOL GetTileInfo(PLVTILEINFO plvti) const;

Parameterwaarden

plvti
Een aanwijzer naar een LVTILEINFO structuur die de tegelgegevens ontvangt.

Retourwaarde

De retourwaarde wordt niet gebruikt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETTILEINFO bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetTileViewInfo

Hiermee wordt informatie opgehaald over een besturingselement voor de lijstweergave in de tegelweergave.

BOOL GetTileViewInfo(PLVTILEVIEWINFO ptvi) const;

Parameterwaarden

ptvi
Een aanwijzer naar een LVTILEVIEWINFO structuur die de opgehaalde informatie ontvangt.

Retourwaarde

De retourwaarde wordt niet gebruikt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETTILEVIEWINFO bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetToolTips

Hiermee haalt u het besturingselement knopinfo op dat door het besturingselement voor de lijstweergave wordt gebruikt om knopinfo weer te geven.

CToolTipCtrl* GetToolTips() const;

Retourwaarde

Een aanwijzer naar een CToolTipCtrl object dat door het lijstbeheer moet worden gebruikt. Als de Create lidfunctie de stijl LVS_NOTOOLTIPSgebruikt, worden er geen knopinfo gebruikt en wordt NULL geretourneerd.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht LVM_GETTOOLTIPS, zoals beschreven in de Windows SDK. De MFC-implementatie van GetToolTips retourneert een CToolTipCtrl object, dat wordt gebruikt door het lijstbeheer, in plaats van een ingang naar een besturingselement voor knopinfo.

Example

CToolTipCtrl* pTip = m_myListCtrl.GetToolTips();
if (NULL != pTip)
{
    pTip->UpdateTipText(_T("I'm a list view!"), &m_myListCtrl,
        IDD_MYLISTCTRL);
}

CListCtrl::GetTopIndex

Haalt de index van het meest zichtbare item op wanneer deze zich in de lijstweergave of rapportweergave bevindt.

int GetTopIndex() const;

Retourwaarde

De index van het bovenste zichtbare item.

Example

// Make sure the focus is set to the list view control.
m_myListCtrl.SetFocus();

// Select all of the items that are completely visible.
int n = m_myListCtrl.GetTopIndex();
int nLast = n + m_myListCtrl.GetCountPerPage();

for (; n < nLast; n++)
{
    m_myListCtrl.SetItemState(n, LVIS_SELECTED, LVIS_SELECTED);
    ASSERT(m_myListCtrl.GetItemState(n, LVIS_SELECTED) == LVIS_SELECTED);
}

CListCtrl::GetView

Hiermee haalt u de weergave van het besturingselement lijstweergave op.

DWORD GetView() const;

Retourwaarde

De huidige weergave van het besturingselement lijstweergave.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_GETVIEW bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::GetViewRect

Hiermee haalt u de begrenzingsrechthoek van alle items in het besturingselement lijstweergave op.

BOOL GetViewRect(LPRECT lpRect) const;

Parameterwaarden

lpRect
Adres van een RECT structuur.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De lijstweergave moet zich in de pictogramweergave of een kleine pictogramweergave hebben.

CListCtrl::GetWorkAreas

Hiermee worden de huidige werkgebieden van een besturingselement voor de lijstweergave opgehaald.

void GetWorkAreas(
    int nWorkAreas,
    LPRECT pRect) const;

Parameterwaarden

nWorkAreas
Het aantal RECT structuren in de pRect matrix.

pRect
Een aanwijzer naar een matrix met RECT structuren (of CRect objecten) die de werkgebieden van het besturingselement lijstweergave ontvangen. Waarden in deze structuren bevinden zich in clientcoördinaten.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_GetWorkAreaszoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::GetNumberOfWorkAreas.

CListCtrl::HasGroup

Bepaalt of het besturingselement voor de lijstweergave de opgegeven groep heeft.

BOOL HasGroup(int iGroupId) const;

Parameterwaarden

iGroupId
De id van de groep die wordt aangevraagd.

Retourwaarde

TRUE Geeft als resultaat het succes, FALSE bij fouten.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_HASGROUP bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::HitTest

Bepaalt welk lijstweergave-item, indien aanwezig, zich op een opgegeven positie bevindt.

int HitTest(LVHITTESTINFO* pHitTestInfo) const;

int HitTest(
    CPoint pt,
    UINT* pFlags = NULL) const;

Parameterwaarden

pHitTestInfo
Adres van een LVHITTESTINFO structuur die de positie bevat waarop de test moet worden bereikt en die informatie ontvangt over de resultaten van de hittest.

pt
Punt dat moet worden getest.

pFlags
Wijs een geheel getal aan dat informatie ontvangt over de resultaten van de test. Bekijk de uitleg van het flags lid van de LVHITTESTINFO structuur in de Windows SDK.

Retourwaarde

De index van het item op de positie die is opgegeven door pHitTestInfo, indien van toepassing, of -1 anders.

Opmerkingen

U kunt de waarden LVHT_TORIGHTLVHT_BELOWLVHT_TOLEFTvan het LVHT_ABOVElid van de structuur flag gebruiken om te bepalen of u door de inhoud van een besturingselement voor de lijstweergave wilt schuiven. Twee van deze vlaggen kunnen worden gecombineerd, bijvoorbeeld als de positie zich boven en links van het clientgebied bevindt.

U kunt testen op de waarde van het LVHT_ONITEM lid van de structuur flag om te bepalen of een bepaalde positie zich boven een lijstweergave-item bevindt. Deze waarde is een bitwise-OR-bewerking op de LVHT_ONITEMICON, LVHT_ONITEMLABELen LVHT_ONITEMSTATEICON waarden van het lid van de structuur flag .

Example

void CListCtrlDlg::OnRClick(NMHDR* pNMHDR, LRESULT* pResult)
{
    LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;
    CPoint point(pia->ptAction);

    // Select the item the user clicked on.
    UINT uFlags;
    int nItem = m_myListCtrl.HitTest(point, &uFlags);

    if (uFlags & LVHT_ONITEMLABEL)
    {
        m_myListCtrl.SetItem(nItem, 0, LVIF_STATE, NULL, 0, LVIS_SELECTED,
            LVIS_SELECTED, 0);
    }

    *pResult = 0;
}

CListCtrl::InsertColumn

Hiermee voegt u een nieuwe kolom in een besturingselement voor de lijstweergave in.

int InsertColumn(
    int nCol,
    const LVCOLUMN* pColumn);

int InsertColumn(
    int nCol,
    LPCTSTR lpszColumnHeading,
    int nFormat = LVCFMT_LEFT,
    int nWidth = -1,
    int nSubItem = -1);

Parameterwaarden

nCol
De index van de nieuwe kolom.

pColumn
Adres van een LVCOLUMN structuur die de kenmerken van de nieuwe kolom bevat.

lpszColumnHeading
Adres van een tekenreeks die de kop van de kolom bevat.

nFormat
Geheel getal dat de uitlijning van de kolom aangeeft. Het kan een van deze waarden zijn: LVCFMT_LEFT, LVCFMT_RIGHTof LVCFMT_CENTER.

nWidth
Breedte van de kolom, in pixels. Als deze parameter -1 is, is de kolombreedte niet ingesteld.

nSubItem
Index van de subitem die is gekoppeld aan de kolom. Als deze parameter -1 is, is er geen subitem gekoppeld aan de kolom.

Retourwaarde

De index van de nieuwe kolom als dit lukt of anders -1.

Opmerkingen

De meest linkse kolom in een besturingselement voor de lijstweergave moet links zijn uitgelijnd.

De LVCOLUMN structuur bevat de kenmerken van een kolom in de rapportweergave. Het wordt ook gebruikt om informatie over een kolom te ontvangen. Deze structuur wordt beschreven in de Windows SDK.

CListCtrl::InsertGroup

Hiermee voegt u een groep in het besturingselement lijstweergave in.

LRESULT InsertGroup(
    int index,
    PLVGROUP pgrp);

Parameterwaarden

index
De index van het item waarin de groep moet worden ingevoegd.

pgrp
Een aanwijzer naar een LVGROUP structuur die de groep bevat die moet worden toegevoegd.

Retourwaarde

Retourneert de index van het item waaraan de groep is toegevoegd of -1 als de bewerking is mislukt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_INSERTGROUP bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::InsertGroupSorted

Hiermee voegt u de opgegeven groep in een geordende lijst met groepen in.

LRESULT InsertGroupSorted(PLVINSERTGROUPSORTED pStructInsert);

Parameterwaarden

pStructInsert
Een aanwijzer naar een LVINSERTGROUPSORTED structuur die de groep bevat die moet worden ingevoegd.

Retourwaarde

De retourwaarde wordt niet gebruikt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_INSERTGROUPSORTED bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::InsertItem

Hiermee voegt u een item in het besturingselement lijstweergave in.

int InsertItem(const LVITEM* pItem);

int InsertItem(
    int nItem,
    LPCTSTR lpszItem);

int InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

int InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    UINT nState,
    UINT nStateMask,
    int nImage,
    LPARAM lParam);

Parameterwaarden

pItem
Wijs een LVITEM-structuur aan waarmee de kenmerken van het item worden opgegeven, zoals beschreven in de Windows SDK.

nItem
Index van het item dat moet worden ingevoegd.

lpszItem
Adres van een tekenreeks met het label van het item of LPSTR_TEXTCALLBACK als het item een callback-item is. Zie voor meer informatie over callback-items CListCtrl::GetCallbackMask.

nImage
Index van de afbeelding van het item of I_IMAGECALLBACK als het item een callback-item is. Zie voor meer informatie over callback-items CListCtrl::GetCallbackMask.

nMask
De nMask parameter geeft aan welke itemkenmerken als parameters zijn doorgegeven. Dit kunnen een of meer maskerwaarden zijn die worden beschreven in LVITEM Structuur in de Windows SDK. De geldige waarden kunnen worden gecombineerd met de bitsgewijze OR-operator.

nState
Geeft de status van het item, de statusafbeelding en de overlay-afbeelding aan. Zie de onderwerpenLVITEM Structuur en List-View itemstatussen voor een lijst met geldige vlaggen voor meer informatie.

nStateMask
Geeft aan welke bits van de lidstaatlid worden opgehaald of gewijzigd. Zie LVITEM Structuur in de Windows SDK voor meer informatie.

lParam
Een 32-bits toepassingsspecifieke waarde (64-bits als u voor x64 compileert) die aan het item is gekoppeld. Als deze parameter is opgegeven, moet u het nMask kenmerk LVIF_PARAMinstellen.

Retourwaarde

De index van het nieuwe item als dit lukt of anders -1.

Opmerkingen

Het aanroepen van deze methode kan ertoe leiden dat het bericht naar het LVM_INSERTITEM besturingsvenster wordt verzonden. De bijbehorende berichthandler voor het besturingselement kan de itemtekst onder bepaalde voorwaarden niet instellen (zoals het gebruik van vensterstijlen zoals LVS_OWNERDRAW). Zie de Windows SDK voor meer informatie over deze voorwaarden LVM_INSERTITEM .

Example

CString strText;
int nColumnCount = m_myListCtrl.GetHeaderCtrl()->GetItemCount();

// Insert 10 items in the list view control.
for (int i = 0; i < 10; i++)
{
    strText.Format(TEXT("item %d"), i);

    // Insert the item, select every other item.
    m_myListCtrl.InsertItem(LVIF_TEXT | LVIF_STATE, i, strText,
        (i % 2) == 0 ? LVIS_SELECTED : 0, LVIS_SELECTED, 0, 0);

    // Initialize the text of the subitems.
    for (int j = 1; j < nColumnCount; j++)
    {
        strText.Format(TEXT("sub-item %d %d"), i, j);
        m_myListCtrl.SetItemText(i, j, strText);
    }
}

CListCtrl::InsertMarkHitTest

Hiermee wordt de invoegpositie opgehaald die het dichtst bij een opgegeven punt ligt.

int InsertMarkHitTest(
    LPPOINT pPoint,
    LPLVINSERTMARK plvim) const;

Parameterwaarden

pPoint
Een aanwijzer naar een POINT structuur die de hittestcoördinaten bevat, ten opzichte van het clientgebied van het lijstbeheer.

plvim
Een aanwijzer naar een LVINSERTMARK structuur die de invoegpositie aangeeft die het dichtst bij de coördinaten ligt die zijn gedefinieerd door de puntparameter.

Retourwaarde

De invoegpositie die zich het dichtst bij het opgegeven punt bevindt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_INSERTMARKHITTEST bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::IsGroupViewEnabled

Bepaalt of de groepsweergave is ingeschakeld voor een besturingselement voor de lijstweergave.

BOOL IsGroupViewEnabled() const;

Retourwaarde

Retourneert TRUE als groepsweergave is ingeschakeld of FALSE anderszins.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_ISGROUPVIEWENABLED bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::IsItemVisible

Hiermee wordt aangegeven of een opgegeven item in het huidige besturingselement voor lijstweergave zichtbaar is.

BOOL IsItemVisible(int index) const;

Parameterwaarden

index
[in] Op nul gebaseerde index van een item in het huidige besturingselement voor lijstweergave.

Retourwaarde

TRUE als het opgegeven item zichtbaar is; anders, FALSE.

Opmerkingen

Met deze methode wordt het LVM_ISITEMVISIBLE bericht verzonden, dat wordt beschreven in de Windows SDK.

CListCtrl::MapIDToIndex

Hiermee wordt de unieke id van een item in het huidige besturingselement voor de lijstweergave toegewezen aan een index.

UINT MapIDToIndex(UINT id) const;

Parameterwaarden

id
[in] De unieke id van een item.

Retourwaarde

De huidige index voor de opgegeven id.

Opmerkingen

Met een besturingselement voor lijstweergave worden items intern bijgehouden per index. Dit kan problemen opleveren omdat indexen kunnen veranderen tijdens de levensduur van het besturingselement. Het besturingselement lijstweergave kan een item taggen met een id wanneer het item wordt gemaakt en u kunt deze id gebruiken om uniekheid te garanderen tijdens de levensduur van het besturingselement voor de lijstweergave.

In een omgeving met meerdere threads wordt de index alleen gegarandeerd op de thread die als host fungeert voor het besturingselement lijstweergave, niet op achtergrondthreads.

Met deze methode wordt het LVM_MAPIDTOINDEX bericht verzonden, dat wordt beschreven in de Windows SDK.

CListCtrl::MapIndexToID

Hiermee wordt de index van een item in het huidige besturingselement voor de lijstweergave toegewezen aan een unieke id.

UINT MapIndexToID(UINT index) const;

Parameterwaarden

index
[in] De op nul gebaseerde index van een item.

Retourwaarde

Een unieke id voor het opgegeven item.

Opmerkingen

Met een besturingselement voor lijstweergave worden items intern bijgehouden per index. Dit kan problemen opleveren omdat indexen kunnen veranderen tijdens de levensduur van het besturingselement. Het besturingselement lijstweergave kan een item taggen met een id wanneer het item wordt gemaakt. U kunt deze id gebruiken om toegang te krijgen tot een specifiek item voor de levensduur van het besturingselement voor de lijstweergave.

In een omgeving met meerdere threads wordt de index alleen gegarandeerd op de thread die als host fungeert voor het besturingselement lijstweergave, niet op achtergrondthreads.

Met deze methode wordt het LVM_MAPINDEXTOID bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_listCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor lijstweergave. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

In het volgende codevoorbeeld ziet u de MapIndexToID methode. In een eerdere sectie van dit codevoorbeeld hebben we een besturingselement voor lijstweergave gemaakt waarin twee kolommen met de titel 'ClientID' en 'Grade' in een rapportweergave worden weergegeven. In het volgende voorbeeld wordt de index van elk lijstweergave-item toegewezen aan een identificatienummer en wordt vervolgens de index voor elk identificatienummer opgehaald. Ten slotte rapporteert het voorbeeld of de oorspronkelijke indexen zijn opgehaald.

// MapIndexToID
int iCount = m_listCtrl.GetItemCount();
UINT nId = 0;
UINT nIndex = 0;
for (int iIndexOriginal = 0; iIndexOriginal < iCount; iIndexOriginal++)
{
    // Map index to ID.
    nId = m_listCtrl.MapIndexToID((UINT)iIndexOriginal);

    // Map ID to index.
    nIndex = m_listCtrl.MapIDToIndex(nId);

    if (nIndex != (UINT)(iIndexOriginal))
    {
        CString str;
        str.Format(_T("Mapped index (%d) is not equal to original index (%d)"),
            nIndex, (UINT)(iIndexOriginal));
        AfxMessageBox(str);
        return;
    }
}
AfxMessageBox(_T("The mapped indexes and original indexes are equal."),
    MB_ICONINFORMATION);

CListCtrl::MoveGroup

Hiermee verplaatst u de opgegeven groep naar de opgegeven op nul gebaseerde index van het besturingselement lijstweergave.

LRESULT MoveGroup(
    int iGroupId,
    int toIndex);

Parameterwaarden

iGroupId
De id van de groep die moet worden verplaatst.

toIndex
De op nul gebaseerde index waar de groep moet worden verplaatst.

Retourwaarde

De retourwaarde wordt niet gebruikt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_MOVEGROUP bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::MoveItemToGroup

Hiermee verplaatst u het opgegeven item naar de opgegeven groep.

void MoveItemToGroup(
    int idItemFrom,
    int idGroupTo);

Parameterwaarden

idItemFrom
[in] De index van het item dat moet worden verplaatst.

idGroupTo
[in] De id van de groep naar het item wordt verplaatst.

Opmerkingen

Opmerking

Deze methode is momenteel niet geïmplementeerd.

Met deze methode wordt de functionaliteit van het LVM_MOVEITEMTOGROUP bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::RedrawItems

Hiermee dwingt u een besturingselement voor de lijstweergave om een reeks items opnieuw te maken.

BOOL RedrawItems(
    int nFirst,
    int nLast);

Parameterwaarden

nFirst
Index van het eerste item dat opnieuw moet worden geschilderd.

nLast
Index van het laatste item dat opnieuw moet worden geschilderd.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De opgegeven items worden pas opnieuw geschilderd nadat het venster van de lijstweergave een WM_PAINT bericht ontvangt. Als u deze functie onmiddellijk opnieuw wilt gebruiken, roept u de Windows-functie UpdateWindow aan nadat u deze functie hebt gebruikt.

CListCtrl::RemoveAllGroups

Hiermee verwijdert u alle groepen uit een besturingselement voor de lijstweergave.

void RemoveAllGroups();

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_REMOVEALLGROUPS bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::RemoveGroup

Hiermee verwijdert u de opgegeven groep uit het besturingselement lijstweergave.

LRESULT RemoveGroup(int iGroupId);

Parameterwaarden

iGroupId
De id van de groep die moet worden verwijderd.

Retourwaarde

Retourneert de index van de groep als deze is geslaagd of -1 anders.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_REMOVEGROUP bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::Scroll

Hiermee schuift u door de inhoud van een besturingselement voor de lijstweergave.

BOOL Scroll(CSize size);

Parameterwaarden

size
Een CSize object dat de hoeveelheid horizontaal en verticaal schuiven opgeeft in pixels. Het y lid van de grootte wordt gedeeld door de hoogte, in pixels, van de lijn van het besturingselement voor de lijstweergave en het besturingselement wordt door het resulterende aantal regels geschoven.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

CListCtrl::SetBkColor

Hiermee stelt u de achtergrondkleur van het besturingselement lijstweergave in.

BOOL SetBkColor(COLORREF cr);

Parameterwaarden

cr
Achtergrondkleur die moet worden ingesteld of de CLR_NONE waarde voor geen achtergrondkleur. Besturingselementen voor lijstweergaven met achtergrondkleuren worden aanzienlijk sneller getekend dan die zonder achtergrondkleuren. Zie de Windows SDK voor meer informatie COLORREF .

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

// Use the 3D button face color for the background.
COLORREF crBkColor = ::GetSysColor(COLOR_3DFACE);
m_myListCtrl.SetBkColor(crBkColor);
ASSERT(m_myListCtrl.GetBkColor() == crBkColor);

CListCtrl::SetBkImage

Hiermee stelt u de achtergrondafbeelding van een besturingselement voor de lijstweergave in.

BOOL SetBkImage(LVBKIMAGE* plvbkImage);

BOOL SetBkImage(
    HBITMAP hBitmap,
    BOOL fTile = TRUE,
    int xOffsetPercent = 0,
    int yOffsetPercent = 0);

BOOL SetBkImage(
    LPTSTR pszUrl,
    BOOL fTile = TRUE,
    int xOffsetPercent = 0,
    int yOffsetPercent = 0);

Parameterwaarden

plvbkImage
Adres van een LVBKIMAGE structuur met de nieuwe achtergrondafbeeldingsgegevens.

hBitmap
Greep naar een bitmap.

pszUrl
Een NULL-beëindigde tekenreeks die de URL van de achtergrondafbeelding bevat.

fTile
Niet-nul als de afbeelding op de achtergrond van het besturingselement voor de lijstweergave moet worden betegeld; anders 0.

xOffsetPercent
De verschuiving, in pixels, van de linkerrand van de afbeelding, van de oorsprong van het besturingselement lijstweergave.

yOffsetPercent
De verschuiving, in pixels, van de bovenrand van de afbeelding, van oorsprong van het besturingselement lijstweergave.

Retourwaarde

Retourneert niet-nul als dit lukt of anders nul.

Opmerkingen

Opmerking

Omdat CListCtrl::SetBkImage ole-com-functionaliteit wordt gebruikt, moeten de OLE-bibliotheken worden geïnitialiseerd voordat ze worden gebruikt SetBkImage. U kunt de COM-bibliotheken het beste initialiseren wanneer de toepassing wordt geïnitialiseerd en de bibliotheken niet geïnitialiseerd wanneer de toepassing wordt beëindigd. Dit wordt automatisch gedaan in MFC-toepassingen die gebruikmaken van ActiveX-technologie, OLE Automation, OLE Linking/Embedding of ODBC/DAO-bewerkingen.

Example

Zie het voorbeeld voor CListCtrl::GetBkImage.

CListCtrl::SetCallbackMask

Hiermee stelt u het callbackmasker in voor een besturingselement voor de lijstweergave.

BOOL SetCallbackMask(UINT nMask);

Parameterwaarden

nMask
Nieuwe waarde van het callbackmasker.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

// Set the callback mask so that only the selected and focused states
// are stored for each item.
m_myListCtrl.SetCallbackMask(LVIS_SELECTED|LVIS_FOCUSED);
ASSERT(m_myListCtrl.GetCallbackMask() ==
    (LVIS_SELECTED|LVIS_FOCUSED));

CListCtrl::SetCheck

Bepaalt of de statusafbeelding van een lijstbeheeritem zichtbaar is.

BOOL SetCheck(
    int nItem,
    BOOL fCheck = TRUE);

Parameterwaarden

nItem
De op nul gebaseerde index van een lijstbesturingselementitem.

fCheck
Hiermee geeft u op of de statusafbeelding van het item zichtbaar moet zijn of niet. fCheck Standaard is dit TRUE en is de statusafbeelding zichtbaar. Als fCheck dat het is FALSE, is het niet zichtbaar.

Retourwaarde

Niet-nul als het item is ingeschakeld, anders 0.

Example

int nCount = m_myListCtrl.GetItemCount();
BOOL fCheck = FALSE;

// Set the check state of every other item to TRUE and
// all others to FALSE.
for (int i = 0; i < nCount; i++)
{
    m_myListCtrl.SetCheck(i, fCheck);
    ASSERT((m_myListCtrl.GetCheck(i) && fCheck) ||
        (!m_myListCtrl.GetCheck(i) && !fCheck));
    fCheck = !fCheck;
}

CListCtrl::SetColumn

Hiermee stelt u de kenmerken van een lijstweergavekolom in.

BOOL SetColumn(
    int nCol,
    const LVCOLUMN* pColumn);

Parameterwaarden

nCol
Index van de kolom waarvan de kenmerken moeten worden ingesteld.

pColumn
Adres van een LVCOLUMN structuur die de nieuwe kolomkenmerken bevat, zoals beschreven in de Windows SDK. Het lid van mask de structuur geeft aan welke kolomkenmerken moeten worden ingesteld. Als het mask lid de LVCF_TEXT waarde opgeeft, is het lid van de structuur pszText het adres van een tekenreeks met null-beëindiging en wordt het lid van cchTextMax de structuur genegeerd.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

Zie het voorbeeld voor CListCtrl::GetColumn.

CListCtrl::SetColumnOrderArray

Hiermee stelt u de kolomvolgorde (van links naar rechts) van een besturingselement voor de lijstweergave in.

BOOL SetColumnOrderArray(
    int iCount,
    LPINT piArray);

Parameterwaarden

piArray
Een aanwijzer naar een buffer met de indexwaarden van de kolommen in het besturingselement lijstweergave (van links naar rechts). De buffer moet groot genoeg zijn om het totale aantal kolommen in het besturingselement lijstweergave te bevatten.

iCount
Aantal kolommen in het besturingselement lijstweergave.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetColumnOrderArrayzoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::GetColumnOrderArray.

CListCtrl::SetColumnWidth

Hiermee wijzigt u de breedte van een kolom in de rapportweergave of lijstweergave.

BOOL SetColumnWidth(
    int nCol,
    int cx);

Parameterwaarden

nCol
Index van de kolom waarvoor de breedte moet worden ingesteld. In de lijstweergave moet deze parameter 0 zijn.

cx
De nieuwe breedte van de kolom. Kan worden LVSCW_AUTOSIZE gebruikt of LVSCW_AUTOSIZE_USEHEADER, zoals beschreven in LVM_SETCOLUMNWIDTH de Windows SDK.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

CListCtrl::SetExtendedStyle

Hiermee stelt u de huidige uitgebreide stijlen van een besturingselement voor de lijstweergave in.

DWORD SetExtendedStyle(DWORD dwNewStyle);

Parameterwaarden

dwNewStyle
Een combinatie van uitgebreide stijlen die moeten worden gebruikt door het besturingselement lijstweergave. Zie het onderwerp Uitgebreide lijstweergavestijlen in de Windows SDK voor een beschrijvende lijst met stijlen.

Retourwaarde

Een combinatie van de vorige uitgebreide stijlen die worden gebruikt door het besturingselement lijstweergave.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetExtendedListViewStylezoals beschreven in de Windows SDK.

Example

// Allow the header controls item to be movable by the user.
m_myListCtrl.SetExtendedStyle
    (m_myListCtrl.GetExtendedStyle()|LVS_EX_HEADERDRAGDROP);

CListCtrl::SetGroupInfo

Hiermee stelt u de informatie in die de opgegeven groep van het huidige besturingselement voor lijstweergave beschrijft.

int SetGroupInfo(
    int iGroupId,
    PLVGROUP pgrp);

Parameterwaarden

iGroupId
De id van de groep waarvan de gegevens zijn ingesteld.

pgrp
Wijs een LVGROUP structuur aan die de gegevens bevat die u wilt instellen. De beller is verantwoordelijk voor het toewijzen van deze structuur en het instellen van de leden.

Retourwaarde

De id van de groep als de methode is geslaagd; anders, -1.

Opmerkingen

Met deze methode wordt het LVM_SETGROUPINFO bericht verzonden, dat wordt beschreven in de Windows SDK.

CListCtrl::SetGroupMetrics

Hiermee stelt u de metrische groepsgegevens van een besturingselement voor de lijstweergave in.

void SetGroupMetrics(PLVGROUPMETRICS pGroupMetrics);

Parameterwaarden

pGroupMetrics
Een aanwijzer naar een LVGROUPMETRICS structuur die de metrische gegevens van de groep bevat die moeten worden ingesteld.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETGROUPMETRICS bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetHotCursor

Hiermee stelt u de cursor in die wordt gebruikt wanneer dynamisch bijhouden is ingeschakeld voor een besturingselement voor de lijstweergave.

HCURSOR SetHotCursor(HCURSOR hc);

Parameterwaarden

hc
Een ingang naar een cursorresource, die wordt gebruikt om de hot cursor weer te geven.

Retourwaarde

De ingang voor de vorige hot cursor-resource die wordt gebruikt door het besturingselement lijstweergave.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetHotCursorzoals beschreven in de Windows SDK.

De dynamische cursor, alleen zichtbaar wanneer de aanwijzer is ingeschakeld, wordt weergegeven wanneer de cursor een lijstweergave-item doorgeeft. Selectie aanwijzen is ingeschakeld door de LVS_EX_TRACKSELECT uitgebreide stijl in te stellen.

Example

Zie het voorbeeld voor CListCtrl::GetHotCursor.

CListCtrl::SetHotItem

Hiermee stelt u het huidige dynamische item van een besturingselement voor de lijstweergave in.

int SetHotItem(int iIndex);

Parameterwaarden

iIndex
Op nul gebaseerde index van het item dat moet worden ingesteld als het dynamische item.

Retourwaarde

De op nul gebaseerde index van het eerder hot item.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetHotItemzoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::GetHotItem.

CListCtrl::SetHoverTime

Hiermee stelt u de huidige aanwijstijd van een besturingselement voor de lijstweergave in.

DWORD SetHoverTime(DWORD dwHoverTime = (DWORD)-1);

Parameterwaarden

dwHoverTime
De nieuwe vertraging, in milliseconden, die de muisaanwijzer op een item moet plaatsen voordat het wordt geselecteerd. Als de standaardwaarde wordt doorgegeven, wordt de tijd ingesteld op de standaardaanwijzertijd.

Retourwaarde

De vorige aanwijstijd, in milliseconden.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetHoverTimezoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::GetHoverTime.

CListCtrl::SetIconSpacing

Hiermee stelt u de afstand tussen pictogrammen in een besturingselement voor de lijstweergave in.

CSize SetIconSpacing(
    int cx,
    int cy);

CSize SetIconSpacing(CSize size);

Parameterwaarden

cx
De afstand (in pixels) tussen pictogrammen op de x-as.

cy
De afstand (in pixels) tussen pictogrammen op de y-as.

size
Een CSize object dat de afstand (in pixels) aangeeft tussen pictogrammen op de x- en y-assen.

Retourwaarde

Een CSize object met de vorige waarden voor pictogramafstand.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetIconSpacingzoals beschreven in de Windows SDK.

Example

// Leave lots of space between icons.
m_myListCtrl.SetIconSpacing(CSize(100, 100));

CListCtrl::SetImageList

Hiermee wijst u een lijst met afbeeldingen toe aan een besturingselement voor de lijstweergave.

CImageList* SetImageList(
    CImageList* pImageList,
    int nImageListType);

Parameterwaarden

pImageList
Aanwijzer naar de lijst met afbeeldingen die u wilt toewijzen.

nImageListType
Type afbeeldingslijst. Dit kan een van deze waarden zijn:

• LVSIL_NORMAL Lijst met afbeeldingen met grote pictogrammen.
• LVSIL_SMALL Lijst met afbeeldingen met kleine pictogrammen.
• LVSIL_STATE Lijst met afbeeldingen met statusafbeeldingen.

Retourwaarde

Een aanwijzer naar de vorige lijst met afbeeldingen.

Example

Zie het voorbeeld voor CListCtrl::GetImageList.

CListCtrl::SetInfoTip

Hiermee stelt u de knopinfotekst in.

BOOL SetInfoTip(PLVSETINFOTIP plvInfoTip);

Parameterwaarden

plvInfoTip
Een aanwijzer naar een LVFSETINFOTIP structuur met de informatie die moet worden ingesteld.

Retourwaarde

TRUE Geeft als resultaat het succes, FALSE bij fouten.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETINFOTIP bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetInsertMark

Hiermee stelt u de invoegpositie in op de gedefinieerde positie.

BOOL SetInsertMark(LPLVINSERTMARK plvim);

Parameterwaarden

plvim
Een aanwijzer naar een LVINSERTMARK structuur die aangeeft waar de invoegpositie moet worden ingesteld.

Retourwaarde

Retourneert TRUE indien geslaagd of FALSE anderszins. FALSE wordt geretourneerd als de grootte in het cbSize lid van de LVINSERTMARK structuur niet gelijk is aan de werkelijke grootte van de structuur of wanneer een invoegpositie niet van toepassing is in de huidige weergave.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETINSERTMARK bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetInsertMarkColor

Hiermee stelt u de kleur van de invoegpositie in.

COLORREF SetInsertMarkColor(COLORREF color);

Parameterwaarden

color
Een COLORREF structuur die de kleur opgeeft om de invoegpositie in te stellen.

Retourwaarde

Retourneert een COLORREF structuur met de vorige kleur.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETINSERTMARKCOLOR bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetItem

Hiermee stelt u enkele of alle kenmerken van een lijstweergave-item in.

BOOL SetItem(const LVITEM* pItem);

BOOL SetItem(
    int nItem,
    int nSubItem,
    UINT nMask,
    LPCTSTR lpszItem,
    int nImage,
    UINT nState,
    UINT nStateMask,
    LPARAM lParam);

BOOL SetItem(
    int nItem,
    int nSubItem,
    UINT nMask,
    LPCTSTR lpszItem,
    int nImage,
    UINT nState,
    UINT nStateMask,
    LPARAM lParam,
    int nIndent);

Parameterwaarden

pItem
Adres van een LVITEM structuur die de nieuwe itemkenmerken bevat, zoals beschreven in de Windows SDK. De structuur iItem en iSubItem leden identificeren het item of subitem en het lid van mask de structuur geeft aan welke kenmerken moeten worden ingesteld. Zie de opmerkingen voor meer informatie over het mask lid.

nItem
Index van het item waarvan de kenmerken moeten worden ingesteld.

nSubItem
Index van de subitem waarvan de kenmerken moeten worden ingesteld.

nMask
Hiermee geeft u op welke kenmerken moeten worden ingesteld (zie de opmerkingen).

lpszItem
Adres van een door null beëindigde tekenreeks die het label van het item opgeeft.

nImage
Index van de afbeelding van het item in de lijst met afbeeldingen.

nState
Hiermee geeft u waarden op voor statussen die moeten worden gewijzigd (zie de opmerkingen).

nStateMask
Hiermee geeft u op welke statussen moeten worden gewijzigd (zie de opmerkingen).

lParam
Een 32-bits (64-bits) toepassingsspecifieke waarde die u voor x64 wilt compileren om aan het item te koppelen.

nIndent
Breedte, in pixels, van de inspringing. Als nIndent de door het systeem gedefinieerde minimumbreedte kleiner is, wordt de nieuwe breedte ingesteld op het door het systeem gedefinieerde minimum

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De iItem en iSubItem leden van de LVITEM structuur en de nItem parameters nSubItem identificeren het item en de subitem waarvan de kenmerken moeten worden ingesteld.

Het mask lid van de LVITEM structuur en de nMask parameter geven aan welke itemkenmerken moeten worden ingesteld:

• LVIF_TEXT Het pszText lid of de lpszItem parameter is het adres van een tekenreeks met null-beëindiging. Het cchTextMax lid wordt genegeerd.
• LVIF_STATEHet stateMask lid of nStateMask de parameter geeft aan welke itemstatussen moeten worden gewijzigd en het lid of nState de state parameter de waarden voor die statussen bevat.

Example

Zie het voorbeeld voor CListCtrl::HitTest.

CListCtrl::SetItemCount

Hiermee bereidt u een besturingselement voor de lijstweergave voor het toevoegen van een groot aantal items.

void SetItemCount(int nItems);

Parameterwaarden

nItems
Het aantal items dat het besturingselement uiteindelijk bevat.

Opmerkingen

Als u het aantal items voor een besturingselement voor een virtuele lijstweergave wilt instellen, raadpleegt u CListCtrl::SetItemCountEx.

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetItemCountzoals beschreven in de Windows SDK.

Example

CString str;

// Add 1024 items to the list view control.
m_myListCtrl.SetItemCount(1024);

for (int i = 0; i < 1024; i++)
{
    str.Format(TEXT("item %d"), i);
    m_myListCtrl.InsertItem(i, str);
}

CListCtrl::SetItemCountEx

Hiermee stelt u het aantal items voor een besturingselement voor een virtuele lijstweergave in.

BOOL SetItemCountEx(
    int iCount,
    DWORD dwFlags = LVSICF_NOINVALIDATEALL);

Parameterwaarden

iCount
Het aantal items dat het besturingselement uiteindelijk bevat.

dwFlags
Hiermee geeft u het gedrag van het besturingselement lijstweergave na het opnieuw instellen van het aantal items. Deze waarde kan een combinatie van de volgende zijn:

• LVSICF_NOINVALIDATEALL Het besturingselement lijstweergave wordt niet opnieuw weergegeven, tenzij de betrokken items momenteel worden weergegeven. Dit is de standaardwaarde.
• LVSICF_NOSCROLL Het besturingselement lijstweergave wijzigt de schuifpositie niet wanneer het aantal items wordt gewijzigd.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetItemCountExzoals beschreven in de Windows SDKand mag alleen worden aangeroepen voor virtuele lijstweergaven.

Example

CString str;

// Add 1024 items to the list view control.

// Force my virtual list view control to allocate
// enough memory for my 1024 items.
m_myVirtualListCtrl.SetItemCountEx(1024, LVSICF_NOSCROLL|
    LVSICF_NOINVALIDATEALL);

for (int i = 0; i < 1024; i++)
{
    str.Format(TEXT("item %d"), i);
    m_myVirtualListCtrl.InsertItem(i, str);
}

CListCtrl::SetItemData

Hiermee stelt u de 32-bits (64-bits) toepassingsspecifieke waarde in die is gekoppeld aan het item dat is opgegeven door nItem.

BOOL SetItemData(int nItem, DWORD_PTR dwData);

Parameterwaarden

nItem
Index van het lijstitem waarvan de gegevens moeten worden ingesteld.

dwData
Een 32-bits waarde (64-bits als u voor x64 compileert) om aan het item te koppelen.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze waarde is het lParam lid van de LVITEM structuur, zoals beschreven in de Windows SDK.

Example

// Set the data of each item to be equal to its index.
for (int i = 0; i < m_myListCtrl.GetItemCount(); i++)
{
    m_myListCtrl.SetItemData(i, i);
}

CListCtrl::SetItemIndexState

Hiermee stelt u de status van een item in het huidige besturingselement voor de lijstweergave in.

BOOL SetItemIndexState(
    PLVITEMINDEX pItemIndex,
    DWORD dwState,
    DWORD dwMask) const;

Parameterwaarden

pItemIndex
[in] Wijs een LVITEMINDEX structuur aan waarmee een item wordt beschreven. De beller is verantwoordelijk voor het toewijzen van deze structuur en het instellen van de leden.

dwState
[in] De status voor het instellen van het item. Dit is een bitsgewijze combinatie van statussen van lijstweergaveitems. Geef nul op om de status opnieuw in te stellen, of één om een status in te stellen.

dwMask
[in] Een masker van de geldige bits van de status die is opgegeven door de dwState parameter. Geef een bitsgewijze combinatie (OR) van de statussen van lijstweergaveitems op.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Zie Lijstweergave-itemstatussen voor meer informatie over de dwState parameter.

Zie het stateMask lid van de structuur voor meer informatie over de dwMaskLVITEM parameter.

Met deze methode wordt het LVM_SETITEMINDEXSTATE bericht verzonden, dat wordt beschreven in de Windows SDK.

CListCtrl::SetItemPosition

Hiermee verplaatst u een item naar een opgegeven positie in een besturingselement voor de lijstweergave.

BOOL SetItemPosition(
    int nItem,
    POINT pt);

Parameterwaarden

nItem
Index van het item waarvan de positie moet worden ingesteld.

pt
Een POINT structuur waarin de nieuwe positie, in weergavecoördinaten, van de linkerbovenhoek van het item wordt opgegeven.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Het besturingselement moet in de pictogram- of kleine pictogramweergave staan.

Als het besturingselement lijstweergave de LVS_AUTOARRANGE stijl heeft, wordt de lijstweergave gerangschikt nadat de positie van het item is ingesteld.

Example

Zie het voorbeeld voor CListCtrl::GetItemPosition.

CListCtrl::SetItemState

Hiermee wijzigt u de status van een item in een besturingselement voor de lijstweergave.

BOOL SetItemState(
    int nItem,
    LVITEM* pItem);

BOOL SetItemState(
    int nItem,
    UINT nState,
    UINT nMask);

Parameterwaarden

nItem
Index van het item waarvan de status moet worden ingesteld. Geef -1 door om de statuswijziging toe te passen op alle items.

pItem
Adres van een LVITEM structuur, zoals beschreven in de Windows SDK. Het lid van stateMask de structuur geeft aan welke status-bits moeten worden gewijzigd en het lid van state de structuur bevat de nieuwe waarden voor die bits. De andere leden worden genegeerd.

nState
Nieuwe waarden voor de status-bits. Zie en de LVITEM lidstaatlid voor een lijst met mogelijke waardenCListCtrl::GetNextItem.

nMask
Masker waarmee wordt opgegeven welke status-bits moeten worden gewijzigd. Deze waarde komt overeen met het stateMask-lid van de LVITEM structuur.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De status van een item is een waarde die de beschikbaarheid van het item aangeeft, gebruikersacties aangeeft of anderszins de status van het item weergeeft. In een besturingselement voor de lijstweergave worden bepaalde status-bits gewijzigd, bijvoorbeeld wanneer de gebruiker een item selecteert. Een toepassing kan andere status-bits wijzigen om het item uit te schakelen of te verbergen, of om een overlayafbeelding of statusafbeelding op te geven.

Example

Zie het voorbeeld voor CListCtrl::GetTopIndex.

CListCtrl::SetItemText

Hiermee wijzigt u de tekst van een lijstweergave-item of subitem.

BOOL SetItemText(
    int nItem,
    int nSubItem,
    LPCTSTR lpszText);

Parameterwaarden

nItem
Index van het item waarvan de tekst moet worden ingesteld.

nSubItem
Index van het subitem of nul om het itemlabel in te stellen.

lpszText
Wijs een tekenreeks aan die de tekst van het nieuwe item bevat.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze methode is niet bedoeld voor gebruik met besturingselementen die de LVS_OWNERDATA vensterstijl bevatten (in feite veroorzaakt dit een assertie in builds voor foutopsporing). Zie List-View Overzicht van besturingselementen voor meer informatie over deze stijl voor lijstbesturingselementen.

Example

Zie het voorbeeld voor CListCtrl::InsertItem.

CListCtrl::SetOutlineColor

Hiermee stelt u de kleur van de rand van een besturingselement voor de lijstweergave in als de LVS_EX_BORDERSELECT uitgebreide vensterstijl is ingesteld.

COLORREF SetOutlineColor(COLORREF color);

Parameterwaarden

color
De nieuwe COLORREF structuur met de omtrekkleur.

Retourwaarde

De vorige COLORREF structuur met de omtrekkleur

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETOUTLINECOLOR bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetSelectedColumn

Hiermee stelt u de geselecteerde kolom van het besturingselement lijstweergave in.

LRESULT SetSelectedColumn(int iCol);

Parameterwaarden

iCol
De index van de kolom die moet worden geselecteerd.

Retourwaarde

De retourwaarde wordt niet gebruikt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETSELECTEDCOLUMN bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetSelectionMark

Hiermee stelt u de selectiemarkering van een besturingselement voor de lijstweergave in.

int SetSelectionMark(int iIndex);

Parameterwaarden

iIndex
De op nul gebaseerde index van het eerste item in een meervoudige selectie.

Retourwaarde

De vorige selectiemarkering of -1 als er geen selectiemarkering is.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetSelectionMarkzoals beschreven in de Windows SDK.

Example

Zie het voorbeeld voor CListCtrl::GetSelectionMark.

CListCtrl::SetTextBkColor

Hiermee stelt u de achtergrondkleur van tekst in een besturingselement voor de lijstweergave in.

BOOL SetTextBkColor(COLORREF cr);

Parameterwaarden

cr
Een COLORREF opgeven van de nieuwe tekstachtergrondkleur. Zie de Windows SDK voor meer informatie COLORREF .

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

// Use the 3D button face color for the background.
COLORREF crBkColor = ::GetSysColor(COLOR_3DFACE);
m_myListCtrl.SetTextBkColor(crBkColor);
ASSERT(m_myListCtrl.GetTextBkColor() == crBkColor);

CListCtrl::SetTextColor

Hiermee stelt u de tekstkleur van een besturingselement voor de lijstweergave in.

BOOL SetTextColor(COLORREF cr);

Parameterwaarden

cr
Een COLORREF vermelding die de nieuwe tekstkleur opgeeft. Zie de Windows SDK voor meer informatie COLORREF .

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Example

// Use the window text color for
// the item text of the list view control.
COLORREF crTextColor = ::GetSysColor(COLOR_WINDOWTEXT);
m_myListCtrl.SetTextColor(crTextColor);
ASSERT(m_myListCtrl.GetTextColor() == crTextColor);

CListCtrl::SetTileInfo

Hiermee stelt u de informatie in voor een tegel van het besturingselement lijstweergave.

BOOL SetTileInfo(PLVTILEINFO pTileInfo);

Parameterwaarden

pTileInfo
Een aanwijzer naar een LVTILEINFO structuur met de informatie die moet worden ingesteld.

Retourwaarde

TRUE Geeft als resultaat het succes, FALSE bij fouten.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETTILEINFO bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetTileViewInfo

Hiermee stelt u informatie in die een besturingselement voor de lijstweergave gebruikt in de tegelweergave.

BOOL SetTileViewInfo(PLVTILEVIEWINFO ptvi);

Parameterwaarden

ptvi
Een aanwijzer naar een LVTILEVIEWINFO structuur met de informatie die moet worden ingesteld.

Retourwaarde

TRUE Geeft als resultaat het succes, FALSE bij fouten.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETTILEVIEWINFO bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetToolTips

Hiermee stelt u het besturingselement voor knopinfo in dat door het besturingselement voor de lijstweergave wordt gebruikt om knopinfo weer te geven.

CToolTipCtrl* SetToolTips(CToolTipCtrl* pWndTip);

Parameterwaarden

pWndTip
Een aanwijzer naar een CToolTipCtrl object dat door het lijstbeheer wordt gebruikt.

Retourwaarde

Een aanwijzer naar een CToolTipCtrl object met de knopinfo die eerder door het besturingselement is gebruikt, of NULL als er eerder geen knopinfo is gebruikt.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht LVM_SETTOOLTIPS, zoals beschreven in de Windows SDK.

Als u knopinfo niet wilt gebruiken, geeft u de LVS_NOTOOLTIPS stijl aan wanneer u het CListCtrl object maakt.

CListCtrl::SetView

Hiermee stelt u de weergave van het besturingselement voor de lijstweergave in.

DWORD SetView(int iView);

Parameterwaarden

iView
De weergave die moet worden geselecteerd.

Retourwaarde

Retourneert 1 als dit lukt of -1 anders. -1 wordt bijvoorbeeld geretourneerd als de weergave ongeldig is.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SETVIEW bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SetWorkAreas

Hiermee stelt u het gebied in waar pictogrammen kunnen worden weergegeven in een besturingselement voor de lijstweergave.

void SetWorkAreas(
    int nWorkAreas,
    LPRECT lpRect);

Parameterwaarden

nWorkAreas
Het aantal RECT structuren (of CRect objecten) in de matrix die door lpRect.

lpRect
Het adres van een matrix met RECT structuren (of CRect objecten) die de nieuwe werkgebieden van het besturingselement lijstweergave opgeven. Deze gebieden moeten worden opgegeven in clientcoördinaten. Als deze parameter is NULL, wordt het werkgebied ingesteld op het clientgebied van het besturingselement.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SetWorkAreaszoals beschreven in de Windows SDK.

Example

// Remove all working areas.
m_myListCtrl.SetWorkAreas(0, NULL);

CListCtrl::SortGroups

Maakt gebruik van een door de toepassing gedefinieerde vergelijkingsfunctie om groepen te sorteren op id in een besturingselement voor lijstweergaven.

BOOL SortGroups(
    PFNLVGROUPCOMPARE _pfnGroupCompare,
    LPVOID _plv);

Parameterwaarden

_pfnGroupCompare
Een aanwijzer naar de groepsvergelijkingsfunctie.

_plv
Een ongeldige aanwijzer.

Retourwaarde

TRUE Geeft als resultaat het succes, FALSE bij fouten.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het LVM_SORTGROUPS bericht geëmuleren, zoals beschreven in de Windows SDK.

CListCtrl::SortItems

Hiermee sorteert u lijstweergave-items met behulp van een door de toepassing gedefinieerde vergelijkingsfunctie.

BOOL SortItems(
    PFNLVCOMPARE pfnCompare,
    DWORD_PTR dwData);

Parameterwaarden

pfnCompare
[in] Adres van de door de toepassing gedefinieerde vergelijkingsfunctie.

Met de sorteerbewerking wordt de vergelijkingsfunctie aangeroepen telkens wanneer de relatieve volgorde van twee lijstitems moet worden bepaald. De vergelijkingsfunctie moet een statisch lid zijn van een klasse of een zelfstandige functie die geen lid is van een klasse.

dwData
[in] Toepassingsgedefinieerde waarde die wordt doorgegeven aan de vergelijkingsfunctie.

Retourwaarde

TRUE indien de methode is geslaagd; anders FALSE.

Opmerkingen

Met deze methode wordt de index van elk item gewijzigd zodat deze overeenkomt met de nieuwe reeks.

De vergelijkingsfunctie, pfnCompareheeft de volgende vorm:

int CALLBACK CompareFunc(LPARAM lParam1,
    LPARAM lParam2,
    LPARAM lParamSort);

De vergelijkingsfunctie moet een negatieve waarde retourneren als het eerste item moet voorafgaan aan het tweede, een positieve waarde als het eerste item de tweede moet volgen of nul als de twee items gelijk zijn.

De lParam1 parameter is de 32-bits waarde (64-bits als u voor x64 compileert) die is gekoppeld aan het eerste item dat wordt vergeleken en de lParam2 parameter is de waarde die is gekoppeld aan het tweede item. Dit zijn de waarden die zijn opgegeven in het lParam lid van de structuur van de items LVITEM toen ze in de lijst werden ingevoegd. De lParamSort parameter is hetzelfde als de dwData waarde.

Met deze methode wordt het LVM_SORTITEMS bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

Hier volgt een eenvoudige vergelijkingsfunctie waarmee items op basis van hun lParam waarden worden gesorteerd.

// Sort items by associated lParam
int CALLBACK CListCtrlDlg::MyCompareProc(LPARAM lParam1, LPARAM lParam2,
    LPARAM lParamSort)
{
    UNREFERENCED_PARAMETER(lParamSort);
    return (int)(lParam1 - lParam2);
}

// Sort the items by passing in the comparison function.
void CListCtrlDlg::Sort()
{
    m_myListCtrl.SortItems(&CListCtrlDlg::MyCompareProc, 0);
}

CListCtrl::SortItemsEx

Hiermee sorteert u de items van het huidige besturingselement voor lijstweergave met behulp van een door de toepassing gedefinieerde vergelijkingsfunctie.

BOOL SortItemsEx(
    PFNLVCOMPARE pfnCompare,
    DWORD_PTR dwData);

Parameterwaarden

pfnCompare
[in] Adres van de door de toepassing gedefinieerde vergelijkingsfunctie. Met de sorteerbewerking wordt de vergelijkingsfunctie aangeroepen telkens wanneer de relatieve volgorde van twee lijstitems moet worden bepaald. De vergelijkingsfunctie moet een statisch lid zijn van een klasse of een zelfstandige functie die geen lid is van een klasse.

dwData
[in] Toepassingsgedefinieerde waarde doorgegeven aan de vergelijkingsfunctie.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt de index van elk item gewijzigd zodat deze overeenkomt met de nieuwe reeks.

De vergelijkingsfunctie, pfnCompareheeft de volgende vorm:

int CALLBACK CompareFunc(LPARAM lParam1,
    LPARAM lParam2,
    LPARAM lParamSort);

Dit bericht is vergelijkbaar LVM_SORTITEMS, met uitzondering van het type informatie dat wordt doorgegeven aan de vergelijkingsfunctie. In LVM_SORTITEMSen lParam1lParam2 zijn de waarden van de items die moeten worden vergeleken. lParam1 Is LVM_SORTITEMSEXde huidige index van het eerste item dat moet worden vergeleken en lParam2 is de huidige index van het tweede item. U kunt een LVM_GETITEMTEXT bericht verzenden om meer informatie over een item op te halen.

De vergelijkingsfunctie moet een negatieve waarde retourneren als het eerste item moet voorafgaan aan het tweede, een positieve waarde als het eerste item de tweede moet volgen of nul als de twee items gelijk zijn.

Opmerking

Tijdens het sorteerproces is de inhoud van de lijstweergave instabiel. Als de callback-functie berichten verzendt naar het besturingselement voor de lijstweergave dan LVM_GETITEM, zijn de resultaten onvoorspelbaar.

Met deze methode wordt het LVM_SORTITEMSEX bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het eerste codevoorbeeld wordt een variabele gedefinieerd, m_listCtrldie wordt gebruikt voor toegang tot het huidige besturingselement voor lijstweergave. Deze variabele wordt gebruikt in het volgende voorbeeld.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

In het volgende codevoorbeeld ziet u de SortItemEx methode. In een eerdere sectie van dit codevoorbeeld hebben we een besturingselement voor lijstweergave gemaakt waarin twee kolommen met de titel 'ClientID' en 'Grade' in een rapportweergave worden weergegeven. In het volgende codevoorbeeld wordt de tabel gesorteerd met behulp van de waarden in de kolom Cijfer.

// The ListCompareFunc() method is a global function used by SortItemEx().
int CALLBACK ListCompareFunc(
                             LPARAM lParam1,
                             LPARAM lParam2,
                             LPARAM lParamSort)
{
    CListCtrl* pListCtrl = (CListCtrl*) lParamSort;
    CString    strItem1 = pListCtrl->GetItemText(static_cast<int>(lParam1), 1);
    CString    strItem2 = pListCtrl->GetItemText(static_cast<int>(lParam2), 1)
    int x1 = _tstoi(strItem1.GetBuffer());
    int x2 = _tstoi(strItem2.GetBuffer());
    int result = 0;
    if ((x1 - x2) < 0)
        result = -1;
    else if ((x1 - x2) == 0)
        result = 0;
    else
        result = 1;

    return result;
}

void CCListCtrl_s2Dlg::OnBnClickedButton1()
{
    // SortItemsEx
    m_listCtrl.SortItemsEx( ListCompareFunc, (LPARAM)&m_listCtrl );
}

CListCtrl::SubItemHitTest

Bepaalt welk lijstweergave-item, indien aanwezig, zich op een bepaalde positie bevindt.

int SubItemHitTest(LPLVHITTESTINFO pInfo);

Parameterwaarden

pInfo
Een aanwijzer naar de LVHITTESTINFO structuur.

Retourwaarde

De op één gebaseerde index van het item of subitem dat wordt getest (indien van toepassing) of -1 anders.

Opmerkingen

Deze lidfunctie implementeert het gedrag van de Win32-macro, ListView_SubItemHitTestzoals beschreven in de Windows SDK.

Example

void CListCtrlDlg::OnDblClk(NMHDR* pNMHDR, LRESULT* pResult)
{
    UNREFERENCED_PARAMETER(pResult);
    LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;
    LVHITTESTINFO lvhti;

    // Clear the subitem text the user clicked on.
    lvhti.pt = pia->ptAction;
    m_myListCtrl.SubItemHitTest(&lvhti);

    if (lvhti.flags & LVHT_ONITEMLABEL)
    {
        m_myListCtrl.SetItemText(lvhti.iItem, lvhti.iSubItem, NULL);
    }
}

CListCtrl::Update

Hiermee dwingt u af dat het besturingselement voor de lijstweergave het opgegeven item opnieuw moet opgeven nItem.

BOOL Update(int nItem);

Parameterwaarden

nItem
Index van het item dat moet worden bijgewerkt.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Met deze functie wordt ook het besturingselement voor de lijstweergave gerangschikt als deze de LVS_AUTOARRANGE stijl heeft.

Example

Zie het voorbeeld voor CListCtrl::GetSelectedCount.

Zie ook

MFC-voorbeeldRIJLIJST
CWnd klasse
Hiërarchiegrafiek
CImageList klasse