CVSListBox-Klasse
Die CVSListBox Klasse unterstützt ein bearbeitbares Listensteuerelement.
Syntax
class CVSListBox : public CVSListBoxBase
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CVSListBox::CVSListBox | Erstellt ein CVSListBox-Objekt. |
CVSListBox::~CVSListBox |
Destruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CVSListBox::AddItem | Fügt einem Listensteuerelement eine Zeichenfolge hinzu. (Überschreibt CVSListBoxBase::AddItem.) |
| CVSListBox::EditItem | Startet einen Bearbeitungsvorgang für den Text eines Listensteuerelementelements. (Überschreibt CVSListBoxBase::EditItem.) |
| CVSListBox::GetCount | Ruft die Anzahl der Zeichenfolgen in einem bearbeitbaren Listensteuerelement ab. (Überschreibt CVSListBoxBase::GetCount.) |
| CVSListBox::GetItemData | Ruft einen anwendungsspezifischen 32-Bit-Wert ab, der einem bearbeitbaren Listensteuerelementelement zugeordnet ist. (Überschreibt CVSListBoxBase::GetItemData.) |
| CVSListBox::GetItemText | Ruft den Text eines bearbeitbaren Listensteuerelementelements ab. (Überschreibt CVSListBoxBase::GetItemText.) |
| CVSListBox::GetSelItem | Ruft den nullbasierten Index des aktuell ausgewählten Elements in einem bearbeitbaren Listensteuerelement ab. (Überschreibt CVSListBoxBase::GetSelItem.) |
CVSListBox::PreTranslateMessage |
Übersetzt Fensternachrichten, bevor sie an die Windows-Funktionen TranslateMessage und DispatchMessage verteilt werden. Weitere Informationen und Methodensyntax finden Sie unter "CWnd::P reTranslateMessage". (Überschreibt CVSListBoxBase::PreTranslateMessage.) |
| CVSListBox::RemoveItem | Entfernt ein Element aus einem bearbeitbaren Listensteuerelement. (Überschreibt CVSListBoxBase::RemoveItem.) |
| CVSListBox::SelectItem | Wählt eine bearbeitbare Listensteuerelementzeichenfolge aus. (Überschreibt CVSListBoxBase::SelectItem.) |
| CVSListBox::SetItemData | Ordnet einem bearbeitbaren Listensteuerelementelement einen anwendungsspezifischen 32-Bit-Wert zu. (Überschreibt CVSListBoxBase::SetItemData.) |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CVSListBox::GetListHwnd | Gibt das Handle an das aktuelle eingebettete Listenansichtssteuerelement zurück. |
Hinweise
Die CVSListBox Klasse stellt eine Reihe von Bearbeitungsschaltflächen bereit, mit denen der Benutzer die Elemente in einem Listensteuerelement erstellen, ändern, löschen oder neu anordnen kann.
Es folgt ein Bild des bearbeitbaren Listensteuerelements. Der zweite Listeneintrag mit dem Titel "Element2" wird zur Bearbeitung ausgewählt.
Wenn Sie den Ressourcen-Editor verwenden, um ein bearbeitbares Listensteuerelement hinzuzufügen, beachten Sie, dass der Toolboxbereich des Editors kein vordefiniertes bearbeitbares Listensteuerelement bereitstellt. Fügen Sie stattdessen ein statisches Steuerelement wie das Gruppenfeld-Steuerelement hinzu. Das Framework verwendet das statische Steuerelement als Platzhalter, um die Größe und Position des bearbeitbaren Listensteuerelements anzugeben.
Um ein bearbeitbares Listensteuerelement in einer Dialogfeldvorlage zu verwenden, deklarieren Sie eine CVSListBox Variable in Ihrer Dialogfeldklasse. Um den Datenaustausch zwischen der Variablen und dem Steuerelement zu unterstützen, definieren Sie einen DDX_Control Makroeintrag in der DoDataExchange Methode des Dialogfelds. Standardmäßig wird das bearbeitbare Listensteuerelement ohne Bearbeitungsschaltflächen erstellt. Verwenden Sie die geerbte CVSListBoxBase::SetStandardButtons-Methode, um die Bearbeitungsschaltflächen zu aktivieren.
Weitere Informationen finden Sie im Beispielverzeichnis, im Beispielverzeichnis, in den New Controls Dateien Page3.cpp und Page3.h.
Vererbungshierarchie
CVSListBoxBase
Anforderungen
Header: afxvslistbox.h
CVSListBox::AddItem
Fügt einem Listensteuerelement eine Zeichenfolge hinzu.
virtual int AddItem(
const CString& strIext,
DWORD_PTR dwData=0,
int iIndex=-1);
Parameter
strIext
[in] Ein Verweis auf eine Zeichenfolge.
dwData
[in] Ein anwendungsspezifischer 32-Bit-Wert, der der Zeichenfolge zugeordnet ist. Der Standardwert ist 0.
iIndex
[in] Der nullbasierte Index der Position, die die Zeichenfolge enthält. Wenn der iIndex-Parameter -1 ist, wird die Zeichenfolge am Ende der Liste hinzugefügt. Der Standardwert ist -1.
Rückgabewert
Der nullbasierte Index der Position der Zeichenfolge im Listensteuerelement.
Hinweise
Verwenden Sie die CVSListBox::GetItemData-Methode , um den Wert abzurufen, der vom dwData-Parameter angegeben wird. Dieser Wert kann eine anwendungsspezifische ganze Zahl oder ein Zeiger auf andere Daten sein.
CVSListBox::CVSListBox
Erstellt ein CVSListBox-Objekt.
CVSListBox();
Rückgabewert
Bemerkungen
CVSListBox::EditItem
Startet einen Bearbeitungsvorgang für den Text eines Listensteuerelementelements.
virtual BOOL EditItem(int iIndex);
Parameter
iIndex
[in] Nullbasierter Index eines Listensteuerelementelements.
Rückgabewert
TRUE, wenn der Bearbeitungsvorgang erfolgreich gestartet wird; andernfalls FALSE.
Hinweise
Der Benutzer startet einen Bearbeitungsvorgang entweder durch Doppelklicken auf die Beschriftung eines Elements oder durch Drücken der F2 - oder LEERTASTE , wenn ein Element den Fokus hat.
CVSListBox::GetCount
Ruft die Anzahl der Zeichenfolgen in einem bearbeitbaren Listensteuerelement ab.
virtual int GetCount() const;
Rückgabewert
Die Anzahl der Elemente im Listensteuerelement.
Hinweise
Beachten Sie, dass die Anzahl ein größer als der Indexwert des letzten Elements ist, da der Index nullbasiert ist.
CVSListBox::GetItemData
Ruft einen anwendungsspezifischen 32-Bit-Wert ab, der einem bearbeitbaren Listensteuerelementelement zugeordnet ist.
virtual DWORD_PTR GetItemData(int iIndex) const;
Parameter
iIndex
[in] Der nullbasierte Index eines bearbeitbaren Listensteuerelementelements.
Rückgabewert
Der 32-Bit-Wert, der dem angegebenen Element zugeordnet ist.
Hinweise
Verwenden Sie die CVSListBox::SetItemData - oder CVSListBox::AddItem-Methode , um den 32-Bit-Wert dem Listensteuerelementelement zuzuordnen. Dieser Wert kann eine anwendungsspezifische ganze Zahl oder ein Zeiger auf andere Daten sein.
CVSListBox::GetItemText
Ruft den Text eines bearbeitbaren Listensteuerelementelements ab.
virtual CString GetItemText(int iIndex) const;
Parameter
iIndex
[in] Der nullbasierte Index eines bearbeitbaren Listensteuerelementelements.
Rückgabewert
Ein CString-Objekt , das den Text des angegebenen Elements enthält.
Hinweise
CVSListBox::GetListHwnd
Gibt das Handle an das aktuelle eingebettete Listenansichtssteuerelement zurück.
virtual HWND GetListHwnd() const;
Rückgabewert
Ein Handle für das eingebettete Listenansichtssteuerelement.
Hinweise
Verwenden Sie diese Methode, um ein Handle für das eingebettete Listenansicht-Steuerelement abzurufen, das die CVSListBox Klasse unterstützt.
CVSListBox::GetSelItem
Ruft den nullbasierten Index des aktuell ausgewählten Elements in einem bearbeitbaren Listensteuerelement ab.
virtual int GetSelItem() const;
Rückgabewert
Wenn diese Methode erfolgreich ist, wird der nullbasierte Index des aktuell ausgewählten Elements verwendet. andernfalls -1.
Hinweise
CVSListBox::RemoveItem
Entfernt ein Element aus einem bearbeitbaren Listensteuerelement.
virtual BOOL RemoveItem(int iIndex);
Parameter
iIndex
[in] Der nullbasierte Index eines bearbeitbaren Listensteuerelementelements.
Rückgabewert
TRUE, wenn das angegebene Element entfernt wird; andernfalls FALSE.
Hinweise
CVSListBox::SelectItem
Wählt eine bearbeitbare Listensteuerelementzeichenfolge aus.
virtual BOOL SelectItem(int iItem);
Parameter
iItem
[in] Der nullbasierte Index eines bearbeitbaren Listensteuerelementelements.
Rückgabewert
TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.
Hinweise
Mit dieser Methode wird das angegebene Element ausgewählt, und wenn es erforderlich ist, scrollt das Element in die Ansicht.
CVSListBox::SetItemData
Ordnet einem bearbeitbaren Listensteuerelementelement einen anwendungsspezifischen 32-Bit-Wert zu.
virtual void SetItemData(
int iIndex,
DWORD_PTR dwData);
Parameter
iIndex
[in] Der nullbasierte Index eines bearbeitbaren Listensteuerelementelements.
dwData
[in] Ein 32-Bit-Wert. Dieser Wert kann eine anwendungsspezifische ganze Zahl oder ein Zeiger auf andere Daten sein.
Hinweise
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für