Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
De CVSListBox klasse ondersteunt een bewerkbaar lijstbesturingselement.
Syntaxis
class CVSListBox : public CVSListBoxBase
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CVSListBox::CVSListBox | Maakt een CVSListBox-object. |
CVSListBox::~CVSListBox |
Destructor. |
Openbare methoden
| Naam | Description |
|---|---|
| CVSListBox::AddItem | Hiermee voegt u een tekenreeks toe aan een lijst besturingselement. (Overschrijft CVSListBoxBase::AddItem.) |
| CVSListBox::EditItem | Hiermee start u een bewerking voor het bewerken van de tekst van een lijstbesturingselementitem. (Overschrijft CVSListBoxBase::EditItem.) |
| CVSListBox::GetCount | Hiermee haalt u het aantal tekenreeksen op in een bewerkbaar lijstbesturingselement. (Overschrijft CVSListBoxBase::GetCount.) |
| CVSListBox::GetItemData | Hiermee haalt u een toepassingsspecifieke 32-bits waarde op die is gekoppeld aan een bewerkbaar lijstbesturingselementitem. (Overschrijft CVSListBoxBase::GetItemData.) |
| CVSListBox::GetItemText | Hiermee haalt u de tekst van een bewerkbaar lijstbesturingselementitem op. (Overschrijft CVSListBoxBase::GetItemText.) |
| CVSListBox::GetSelItem | Haalt de op nul gebaseerde index van het geselecteerde item op in een bewerkbaar lijstbesturingselement. (Overschrijft CVSListBoxBase::GetSelItem.) |
CVSListBox::PreTranslateMessage |
Hiermee worden vensterberichten vertaald voordat ze worden verzonden naar de windows-functies TranslateMessage en DispatchMessage . Zie CWnd::P reTranslateMessage voor meer informatie en methodesyntaxis. (Overschrijft CVSListBoxBase::PreTranslateMessage.) |
| CVSListBox::RemoveItem | Hiermee verwijdert u een item uit een bewerkbaar lijstbesturingselement. (Overschrijft CVSListBoxBase::RemoveItem.) |
| CVSListBox::SelectItem | Hiermee selecteert u een bewerkbare lijstbesturingselementtekenreeks. (Overschrijft CVSListBoxBase::SelectItem.) |
| CVSListBox::SetItemData | Koppelt een toepassingsspecifieke 32-bits waarde aan een bewerkbaar lijstbesturingselementitem. (Overschrijft CVSListBoxBase::SetItemData.) |
Beveiligde methoden
| Naam | Description |
|---|---|
| CVSListBox::GetListHwnd | Retourneert de ingang naar het huidige besturingselement voor ingesloten lijstweergave. |
Opmerkingen
De CVSListBox klasse bevat een set bewerkingsknoppen waarmee de gebruiker de items in een lijstbesturingselement kan maken, wijzigen, verwijderen of opnieuw rangschikt.
Hier volgt een afbeelding van het bewerkbare lijstbesturingselement. Het tweede lijstitem, met de titel Item2, is geselecteerd voor bewerking.
Als u de resourceeditor gebruikt om een bewerkbaar lijstbesturingselement toe te voegen, ziet u dat het deelvenster Werkset van de editor geen vooraf gedefinieerd bewerkbaar lijstbesturingselement biedt. Voeg in plaats daarvan een statisch besturingselement toe, zoals het besturingselement Groepsvak . Het framework gebruikt het statische besturingselement als tijdelijke aanduiding om de grootte en positie van het bewerkbare lijstbesturingselement op te geven.
Als u een bewerkbaar lijstbesturingselement in een dialoogvenstersjabloon wilt gebruiken, declareert u een CVSListBox variabele in de dialoogvensterklasse. Als u gegevensuitwisseling tussen de variabele en het besturingselement wilt ondersteunen, definieert u een DDX_Control macro-item in de DoDataExchange methode van het dialoogvenster. Standaard wordt het bewerkbare besturingselement voor lijsten gemaakt zonder bewerkingsknoppen. Gebruik de overgenomen CVSListBoxBase::SetStandardButtons-methode om de bewerkingsknoppen in te schakelen.
Zie de map Voorbeelden, het New Controls voorbeeld, de bestanden Page3.cpp en Page3.h voor meer informatie.
Overnamehiërarchie
CVSListBoxBase
Requirements
Koptekst: afxvslistbox.h
CVSListBox::AddItem
Hiermee voegt u een tekenreeks toe aan een lijst besturingselement.
virtual int AddItem(
const CString& strIext,
DWORD_PTR dwData=0,
int iIndex=-1);
Parameterwaarden
strIext
[in] Een verwijzing naar een tekenreeks.
dwData
[in] Een toepassingsspecifieke 32-bits waarde die is gekoppeld aan de tekenreeks. De standaardwaarde is 0.
iIndex
[in] De op nul gebaseerde index van de positie die de tekenreeks bevat. Als de parameter iIndex -1 is, wordt de tekenreeks toegevoegd aan het einde van de lijst. De standaardwaarde is 1.
Retourwaarde
De op nul gebaseerde index van de positie van de tekenreeks in het lijstbesturingselement.
Opmerkingen
Gebruik de methode CVSListBox::GetItemData om de waarde op te halen die is opgegeven door de parameter dwData . Deze waarde kan een toepassingsspecifiek geheel getal of een aanwijzer naar andere gegevens zijn.
CVSListBox::CVSListBox
Maakt een CVSListBox-object.
CVSListBox();
Retourwaarde
Opmerkingen
CVSListBox::EditItem
Hiermee start u een bewerking voor het bewerken van de tekst van een lijstbesturingselementitem.
virtual BOOL EditItem(int iIndex);
Parameterwaarden
iIndex
[in] Op nul gebaseerde index van een lijstbesturingselementitem.
Retourwaarde
WAAR als de bewerking is gestart; anders, ONWAAR.
Opmerkingen
De gebruiker start een bewerking door te dubbelklikken op het label van een item of door op de toets F2 of spatiebalk te drukken wanneer een item de focus heeft.
CVSListBox::GetCount
Hiermee haalt u het aantal tekenreeksen op in een bewerkbaar lijstbesturingselement.
virtual int GetCount() const;
Retourwaarde
Het aantal items in het lijstbeheer.
Opmerkingen
Houd er rekening mee dat het aantal groter is dan de indexwaarde van het laatste item, omdat de index op nul is gebaseerd.
CVSListBox::GetItemData
Hiermee haalt u een toepassingsspecifieke 32-bits waarde op die is gekoppeld aan een bewerkbaar lijstbesturingselementitem.
virtual DWORD_PTR GetItemData(int iIndex) const;
Parameterwaarden
iIndex
[in] De op nul gebaseerde index van een bewerkbaar lijstbesturingselementitem.
Retourwaarde
De 32-bits waarde die is gekoppeld aan het opgegeven item.
Opmerkingen
Gebruik de methode CVSListBox::SetItemData of CVSListBox::AddItem om de 32-bits waarde aan het lijstbesturingselementitem te koppelen. Deze waarde kan een toepassingsspecifiek geheel getal of een aanwijzer naar andere gegevens zijn.
CVSListBox::GetItemText
Hiermee haalt u de tekst van een bewerkbaar lijstbesturingselementitem op.
virtual CString GetItemText(int iIndex) const;
Parameterwaarden
iIndex
[in] De op nul gebaseerde index van een bewerkbaar lijstbesturingselementitem.
Retourwaarde
Een CString-object dat de tekst van het opgegeven item bevat.
Opmerkingen
CVSListBox::GetListHwnd
Retourneert de ingang naar het huidige besturingselement voor ingesloten lijstweergave.
virtual HWND GetListHwnd() const;
Retourwaarde
Een ingang naar het besturingselement voor de ingesloten lijstweergave.
Opmerkingen
Gebruik deze methode om een ingang op te halen voor het besturingselement voor de ingesloten lijstweergave die ondersteuning biedt voor de CVSListBox klasse.
CVSListBox::GetSelItem
Haalt de op nul gebaseerde index van het geselecteerde item op in een bewerkbaar lijstbesturingselement.
virtual int GetSelItem() const;
Retourwaarde
Als deze methode is geslaagd, wordt de op nul gebaseerde index van het momenteel geselecteerde item; anders, -1.
Opmerkingen
CVSListBox::RemoveItem
Hiermee verwijdert u een item uit een bewerkbaar lijstbesturingselement.
virtual BOOL RemoveItem(int iIndex);
Parameterwaarden
iIndex
[in] De op nul gebaseerde index van een bewerkbaar lijstbesturingselementitem.
Retourwaarde
WAAR als het opgegeven item wordt verwijderd; anders, ONWAAR.
Opmerkingen
CVSListBox::SelectItem
Hiermee selecteert u een bewerkbare lijstbesturingselementtekenreeks.
virtual BOOL SelectItem(int iItem);
Parameterwaarden
iItem
[in] De op nul gebaseerde index van een bewerkbaar lijstbesturingselementitem.
Retourwaarde
WAAR als deze methode is geslaagd; anders, ONWAAR.
Opmerkingen
Met deze methode selecteert u het opgegeven item en schuift u het item, indien nodig, naar de weergave.
CVSListBox::SetItemData
Koppelt een toepassingsspecifieke 32-bits waarde aan een bewerkbaar lijstbesturingselementitem.
virtual void SetItemData(
int iIndex,
DWORD_PTR dwData);
Parameterwaarden
iIndex
[in] De op nul gebaseerde index van een bewerkbaar lijstbesturingselementitem.
dwData
[in] Een 32-bits waarde. Deze waarde kan een toepassingsspecifiek geheel getal of een aanwijzer naar andere gegevens zijn.