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.

CVSListBox-Steuerelement.

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 Verzeichnis "Samples", im Beispiel, in den New Controls Dateien "Page3.cpp" und "Page3.h".

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CStatic

CVSListBoxBase

CVSListBox

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

Weitere Informationen

Hierarchiediagramm
Klassen