`CListBox`-Klasse

Artikel
10/12/2023

Stellt die Funktionalität eines Windows-Listenfelds bereit.

Syntax

class CListBox : public CWnd

Member

Öffentliche Konstruktoren

Name	Beschreibung
`CListBox::CListBox`	Erstellt ein `CListBox`-Objekt.

Öffentliche Methoden

Name	Beschreibung
`CListBox::AddString`	Fügt einem Listenfeld eine Zeichenfolge hinzu.
`CListBox::CharToItem`	Überschreiben, um eine benutzerdefinierte `WM_CHAR` Behandlung für Besitzer-Zeichnen-Listenfelder bereitzustellen, für die keine Zeichenfolgen vorhanden sind.
`CListBox::CompareItem`	Wird vom Framework aufgerufen, um die Position eines neuen Elements in einem sortierten Listenfeld für Besitzer-Zeichnen zu bestimmen.
`CListBox::Create`	Erstellt das Windows-Listenfeld und fügt es an das `CListBox` Objekt an.
`CListBox::DeleteItem`	Wird vom Framework aufgerufen, wenn der Benutzer ein Element aus einem Listenfeld "Besitzer zeichnen" löscht.
`CListBox::DeleteString`	Löscht eine Zeichenfolge aus einem Listenfeld.
`CListBox::Dir`	Fügt Dateinamen, Laufwerke oder beide aus dem aktuellen Verzeichnis zu einem Listenfeld hinzu.
`CListBox::DrawItem`	Wird vom Framework aufgerufen, wenn sich ein visueller Aspekt eines Besitzer-Zeichnen-Listenfelds ändert.
`CListBox::FindString`	Sucht in einem Listenfeld nach einer Zeichenfolge.
`CListBox::FindStringExact`	Sucht die erste Listenfeldzeichenfolge, die einer angegebenen Zeichenfolge entspricht.
`CListBox::GetAnchorIndex`	Ruft den nullbasierten Index des aktuellen Ankerelements in einem Listenfeld ab.
`CListBox::GetCaretIndex`	Bestimmt den Index des Elements, das das Fokusrechteck in einem Listenfeld mit Mehrfachauswahl aufweist.
`CListBox::GetCount`	Gibt die Anzahl der Zeichenfolgen in einem Listenfeld zurück.
`CListBox::GetCurSel`	Gibt den nullbasierten Index der aktuell ausgewählten Zeichenfolge in einem Listenfeld zurück.
`CListBox::GetHorizontalExtent`	Gibt die Breite in Pixeln zurück, in denen ein Listenfeld horizontal gescrollt werden kann.
`CListBox::GetItemData`	Gibt einen Wert zurück, der dem Listenfeldelement zugeordnet ist.
`CListBox::GetItemDataPtr`	Gibt einen Zeiger auf ein Listenfeldelement zurück.
`CListBox::GetItemHeight`	Bestimmt die Höhe von Elementen in einem Listenfeld.
`CListBox::GetItemRect`	Gibt das umgebende Rechteck des Listenfeldelements zurück, wie es derzeit angezeigt wird.
`CListBox::GetListBoxInfo`	Ruft die Anzahl der Elemente pro Spalte ab.
`CListBox::GetLocale`	Ruft den Gebietsschemabezeichner für ein Listenfeld ab.
`CListBox::GetSel`	Gibt den Auswahlstatus eines Listenfeldelements zurück.
`CListBox::GetSelCount`	Gibt die Anzahl der Zeichenfolgen zurück, die derzeit in einem Listenfeld mit Mehrfachauswahl ausgewählt sind.
`CListBox::GetSelItems`	Gibt die Indizes der Zeichenfolgen zurück, die derzeit in einem Listenfeld ausgewählt sind.
`CListBox::GetText`	Kopiert ein Listenfeldelement in einen Puffer.
`CListBox::GetTextLen`	Gibt die Länge in Byte eines Listenfeldelements zurück.
`CListBox::GetTopIndex`	Gibt den Index der ersten sichtbaren Zeichenfolge in einem Listenfeld zurück.
`CListBox::InitStorage`	Stellt Speicherblöcke für Listenfeldelemente und Zeichenfolgen vor.
`CListBox::InsertString`	Fügt eine Zeichenfolge an einer bestimmten Position in ein Listenfeld ein.
`CListBox::ItemFromPoint`	Gibt den Index des Listenfeldelements zurück, das einem Punkt am nächsten liegt.
`CListBox::MeasureItem`	Wird vom Framework aufgerufen, wenn ein Besitzer-Zeichnen-Listenfeld erstellt wird, um Listenfelddimensionen zu bestimmen.
`CListBox::ResetContent`	Löscht alle Einträge aus einem Listenfeld.
`CListBox::SelectString`	Sucht nach einer Zeichenfolge in einem Listenfeld mit einer Auswahl und wählt sie aus.
`CListBox::SelItemRange`	Markiert oder deaktiviert einen Bereich von Zeichenfolgen in einem Listenfeld mit mehrfacher Auswahl.
`CListBox::SetAnchorIndex`	Legt den Anker in einem Listenfeld für Mehrfachauswahl fest, um eine erweiterte Auswahl zu beginnen.
`CListBox::SetCaretIndex`	Legt das Fokusrechteck auf das Element am angegebenen Index in einem Listenfeld mit Mehrfachauswahl fest.
`CListBox::SetColumnWidth`	Legt die Spaltenbreite eines mehrspaltigen Listenfelds fest.
`CListBox::SetCurSel`	Wählt eine Listenfeldzeichenfolge aus.
`CListBox::SetHorizontalExtent`	Legt die Breite in Pixeln fest, in denen ein Listenfeld horizontal gescrollt werden kann.
`CListBox::SetItemData`	Legt einen Wert fest, der dem Listenfeldelement zugeordnet ist.
`CListBox::SetItemDataPtr`	Legt einen Zeiger auf das Listenfeldelement fest.
`CListBox::SetItemHeight`	Legt die Höhe von Elementen in einem Listenfeld fest.
`CListBox::SetLocale`	Legt den Gebietsschemabezeichner für ein Listenfeld fest.
`CListBox::SetSel`	Wählt ein Listenfeldelement in einem Listenfeld-Listenfeld aus oder deaktiviert es.
`CListBox::SetTabStops`	Legt die Tabstopppositionen in einem Listenfeld fest.
`CListBox::SetTopIndex`	Legt den nullbasierten Index der ersten sichtbaren Zeichenfolge in einem Listenfeld fest.
`CListBox::VKeyToItem`	Überschreiben, um benutzerdefinierte `WM_KEYDOWN` Behandlung für Listenfelder mit dem `LBS_WANTKEYBOARDINPUT` Formatvorlagensatz bereitzustellen.

Hinweise

In einem Listenfeld wird eine Liste von Elementen angezeigt, z. B. Dateinamen, die der Benutzer anzeigen und auswählen kann.

In einem Listenfeld mit einer Auswahl kann der Benutzer nur ein Element auswählen. In einem Listenfeld mit Mehrfachauswahl kann ein Elementbereich ausgewählt werden. Wenn der Benutzer ein Element auswählt, wird es hervorgehoben, und das Listenfeld sendet eine Benachrichtigung an das übergeordnete Fenster.

Sie können ein Listenfeld entweder aus einer Dialogfeldvorlage oder direkt in Ihrem Code erstellen. Um es direkt zu erstellen, erstellen Sie das CListBox Objekt, und rufen Sie dann die Create Memberfunktion auf, um das Windows-Listenfeld-Steuerelement zu erstellen und es an das CListBox Objekt anzufügen. Um ein Listenfeld in einer Dialogfeldvorlage zu verwenden, deklarieren Sie eine Listenfeldvariable in Ihrer Dialogfeldklasse, und verwenden Sie DDX_Control dann die Funktion Ihrer Dialogfeldklasse DoDataExchange , um die Membervariable mit dem Steuerelement zu verbinden. (Dies geschieht automatisch, wenn Sie ihrer Dialogfeldklasse eine Steuerelementvariable hinzufügen.)

Die Konstruktion kann ein einstufiger Prozess in einer Klasse sein, die von CListBox. Schreiben Sie einen Konstruktor für die abgeleitete Klasse und den Aufruf Create innerhalb des Konstruktors.

Wenn Sie Windows-Benachrichtigungen behandeln möchten, die von einem Listenfeld an das übergeordnete Element gesendet werden (in der Regel eine von ihnen abgeleitete CDialogKlasse), fügen Sie der übergeordneten Klasse für jede Nachricht eine Elementfunktion für nachrichtenzuordnungs- und message-handler-member hinzu.

Jeder Nachrichtenzuordnungseintrag hat die folgende Form:

ON_Notification( id, memberFxn )

dabei id wird die untergeordnete Fenster-ID des Listenfeld-Steuerelements angegeben, das die Benachrichtigung sendet, und memberFxn der Name der übergeordneten Elementfunktion, die Sie zum Behandeln der Benachrichtigung geschrieben haben.

Der Funktionsprototyp des übergeordneten Elements lautet wie folgt:

afx_msg void memberFxn( );

Nachfolgend finden Sie eine Liste potenzieller Nachrichtenzuordnungseinträge und eine Beschreibung der Fälle, in denen sie an das übergeordnete Element gesendet werden:

ON_LBN_DBLCLK Der Benutzer doppelklicken auf eine Zeichenfolge in einem Listenfeld. Nur ein Listenfeld mit der LBS_NOTIFY Formatvorlage sendet diese Benachrichtigung.
ON_LBN_ERRSPACE Das Listenfeld kann nicht genügend Arbeitsspeicher zuweisen, um die Anforderung zu erfüllen.
ON_LBN_KILLFOCUS Das Listenfeld verliert den Eingabefokus.
ON_LBN_SELCANCEL Die aktuelle Listenfeldauswahl wird abgebrochen. Diese Nachricht wird nur gesendet, wenn ein Listenfeld die LBS_NOTIFY Formatvorlage aufweist.
ON_LBN_SELCHANGE Die Auswahl im Listenfeld wurde geändert. Diese Benachrichtigung wird nicht gesendet, wenn die Auswahl von der CListBox::SetCurSel Memberfunktion geändert wird. Diese Benachrichtigung gilt nur für ein Listenfeld mit der LBS_NOTIFY Formatvorlage. Die LBN_SELCHANGE Benachrichtigung wird für ein Listenfeld mit Mehrfachauswahl gesendet, wenn der Benutzer eine Pfeiltaste drückt, auch wenn sich die Auswahl nicht ändert.
ON_LBN_SETFOCUS Das Listenfeld empfängt den Eingabefokus.
ON_WM_CHARTOITEM Ein Listenfeld mit Besitzer-Zeichnen, das keine Zeichenfolgen enthält, empfängt eine WM_CHAR Nachricht.
ON_WM_VKEYTOITEM Ein Listenfeld mit der LBS_WANTKEYBOARDINPUT Formatvorlage empfängt eine WM_KEYDOWN Nachricht.

Wenn Sie ein CListBox Objekt in einem Dialogfeld (über eine Dialogressource) erstellen, wird das CListBox Objekt automatisch zerstört, wenn der Benutzer das Dialogfeld schließt.

Wenn Sie ein Objekt innerhalb eines CListBox Fensters erstellen, müssen Sie das CListBox Objekt möglicherweise zerstören. Wenn Sie das CListBox Objekt auf dem Stapel erstellen, wird es automatisch zerstört. Wenn Sie das CListBox Objekt auf dem Heap mithilfe der new Funktion erstellen, müssen Sie das Objekt aufrufen delete , um es zu zerstören, wenn der Benutzer das übergeordnete Fenster schließt.

Wenn Sie speicher CListBox im Objekt zuordnen, überschreiben Sie den CListBox Destruktor, um die Zuordnung zu löschen.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CListBox

Anforderungen

Header: afxwin.h

`CListBox::AddString`

Fügt einem Listenfeld eine Zeichenfolge hinzu.

int AddString(LPCTSTR lpszItem);

Parameter

lpszItem
Verweist auf die mit Null beendete Zeichenfolge, die hinzugefügt werden soll.

Rückgabewert

Der nullbasierte Index für die Zeichenfolge im Listenfeld. Der Rückgabewert ist, wenn ein Fehler auftritt. Der Rückgabewert ist LB_ERR LB_ERRSPACE , wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolge verfügbar ist.

Hinweise

Wenn das Listenfeld nicht mit der LBS_SORT Formatvorlage erstellt wurde, wird die Zeichenfolge am Ende der Liste hinzugefügt. Andernfalls wird die Zeichenfolge in die Liste eingefügt, und die Liste wird sortiert. Wenn das Listenfeld mit der LBS_SORT Formatvorlage, aber nicht mit der LBS_HASSTRINGS Formatvorlage erstellt wurde, sortiert das Framework die Liste nach einem oder mehreren Aufrufen der CompareItem Memberfunktion.

Dient InsertString zum Einfügen einer Zeichenfolge an eine bestimmte Position innerhalb des Listenfelds.

Beispiel

// Add 10 items to the list box.
CString str;
for (int i = 0; i < 10; i++)
{
   str.Format(_T("item string %d"), i);
   m_myListBox.AddString(str);
}

`CListBox::CharToItem`

Wird vom Framework aufgerufen, wenn das übergeordnete Fenster des Listenfelds eine WM_CHARTOITEM Nachricht aus dem Listenfeld empfängt.

virtual int CharToItem(
    UINT nKey,
    UINT nIndex);

Parameter

nKey
Der ANSI-Code des Zeichens, das der Benutzer eingegeben hat.

nIndex
Die aktuelle Position des Listenfeld-Caret.

Rückgabewert

Gibt - 1 oder - 2 für keine weitere Aktion oder eine nichtnegative Zahl zurück, um einen Index eines Listenfeldelements anzugeben, für das die Standardaktion für den Tastenanschlag ausgeführt werden soll. Die Standardimplementierung gibt - 1 zurück.

Hinweise

Die WM_CHARTOITEM Nachricht wird vom Listenfeld gesendet, wenn sie eine WM_CHAR Nachricht empfängt, aber nur, wenn das Listenfeld alle diese Kriterien erfüllt:

Ist ein Listenfeld für Besitzer-Zeichnen.
Verfügt nicht über den LBS_HASSTRINGS Formatvorlagensatz.
Verfügt über mindestens ein Element.

Sie sollten diese Funktion niemals selbst aufrufen. Überschreiben Sie diese Funktion, um ihre eigene benutzerdefinierte Behandlung von Tastaturnachrichten bereitzustellen.

In Ihrer Außerkraftsetzung müssen Sie einen Wert zurückgeben, um dem Framework mitzuteilen, welche Aktion Sie ausgeführt haben. Ein Rückgabewert von - 1 oder - 2 gibt an, dass Sie alle Aspekte der Auswahl des Elements behandelt haben und keine weitere Aktion durch das Listenfeld erfordert. Bevor Sie - 1 oder - 2 zurückgeben, können Sie die Markierung festlegen oder das Caret oder beides verschieben. Um die Auswahl festzulegen, verwenden SetCurSel oder SetSel. Um das Caret zu verschieben, verwenden Sie SetCaretIndex.

Ein Rückgabewert von 0 oder höher gibt den Index eines Elements im Listenfeld an und gibt an, dass das Listenfeld die Standardaktion für die Tastatureingabe für das angegebene Element ausführen soll.

Beispiel

// CMyODListBox is my owner-drawn list box derived from CListBox. This
// example moves the caret down one item on a numeric key and up one item
// on an alphabetic key. The list box control was created with the
// following code:
//   m_myODListBox.Create(
//      WS_CHILD|WS_VISIBLE|WS_BORDER|WS_HSCROLL|WS_VSCROLL|
//      LBS_SORT|LBS_MULTIPLESEL|LBS_OWNERDRAWVARIABLE|LBS_WANTKEYBOARDINPUT,
//      CRect(10,250,200,450), pParentWnd, IDC_MYODLISTBOX);
//
int CMyODListBox::CharToItem(UINT nChar, UINT nIndex)
{
   // On a numeric key, move the caret up one item.
   if (isdigit(nChar) && (nIndex > 0))
   {
      SetCaretIndex(nIndex - 1);
   }
   // On an alphabetic key, move the caret down one item.
   else if (isalpha(nChar) && (nIndex < (UINT)GetCount()))
   {
      SetCaretIndex(nIndex + 1);
   }

   // Do not perform any default processing.
   return -1;
}

`CListBox::CListBox`

Erstellt ein CListBox-Objekt.

CListBox();

Hinweise

Sie erstellen ein CListBox Objekt in zwei Schritten. Rufen Sie zuerst den Konstruktor auf, und rufen Sie ihn dann aufCreate, wodurch das Windows-Listenfeld initialisiert und an die CListBoxKonstruktor ClistBox angefügt wird.

Beispiel

// Declare a local CListBox object.
CListBox myListBox;

// Declare a dynamic CListBox object.
CListBox *pmyListBox = new CListBox;

`CListBox::CompareItem`

Wird vom Framework aufgerufen, um die relative Position eines neuen Elements in einem sortierten Listenfeld für Besitzer-Zeichnen zu bestimmen.

virtual int CompareItem(LPCOMPAREITEMSTRUCT lpCompareItemStruct);

Parameter

lpCompareItemStruct
Ein langer Zeiger auf eine COMPAREITEMSTRUCT Struktur.

Rückgabewert

Gibt die relative Position der beiden in der COMPAREITEMSTRUCT Struktur beschriebenen Elemente an. Dabei kann es sich um einen der folgenden Werte handeln:

Wert	Bedeutung
-1	Element 1 sortiert vor Element 2.
0	Element 1 und Element 2 sortieren gleich.
1	Element 1 sortiert nach Element 2.

Eine Beschreibung der Struktur finden Sie unter.See CWnd::OnCompareItem for a description of the COMPAREITEMSTRUCT structure.

Hinweise

Standardmäßig führt diese Memberfunktion nichts aus. Wenn Sie ein Listenfeld "Besitzer-Zeichnen" mit der LBS_SORT Formatvorlage erstellen, müssen Sie diese Memberfunktion außer Kraft setzen, um das Framework beim Sortieren neuer Elemente zu unterstützen, die dem Listenfeld hinzugefügt wurden.

Beispiel

// CMyODListBox is my owner-drawn list box derived from CListBox. This
// example compares two items using _tcscmp to sort items in reverse
// alphabetical order. The list box control was created with the
// following code:
//   m_myODListBox.Create(
//      WS_CHILD|WS_VISIBLE|WS_BORDER|WS_HSCROLL|WS_VSCROLL|
//      LBS_SORT|LBS_MULTIPLESEL|LBS_OWNERDRAWVARIABLE|LBS_WANTKEYBOARDINPUT,
//      CRect(10,250,200,450), pParentWnd, IDC_MYODLISTBOX);
//
int CMyODListBox::CompareItem(LPCOMPAREITEMSTRUCT lpCompareItemStruct)
{
   ASSERT(lpCompareItemStruct->CtlType == ODT_LISTBOX);
   LPCTSTR lpszText1 = (LPCTSTR)lpCompareItemStruct->itemData1;
   ASSERT(lpszText1 != NULL);
   LPCTSTR lpszText2 = (LPCTSTR)lpCompareItemStruct->itemData2;
   ASSERT(lpszText2 != NULL);

   return _tcscmp(lpszText2, lpszText1);
}

`CListBox::Create`

Erstellt das Windows-Listenfeld und fügt es an das CListBox Objekt an.

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

Parameter

dwStyle
Gibt die Formatvorlage des Listenfelds an. Wenden Sie eine beliebige Kombination von Listenfeldformatvorlagen auf das Feld an.

rect
Gibt die Größe und Position des Listenfelds an. Kann ein CRect Objekt oder eine RECT Struktur sein.

pParentWnd
Gibt das übergeordnete Fenster des Listenfelds an (in der Regel ein CDialog Objekt). Es darf nicht sein NULL.

nID
Gibt die Steuerelement-ID des Listenfelds an.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Sie erstellen ein CListBox Objekt in zwei Schritten. Rufen Sie zuerst den Konstruktor auf, und rufen Sie ihn dann auf Create, wodurch das Windows-Listenfeld initialisiert und an das CListBox Objekt angefügt wird.

Bei Create Ausführung sendet Windows die WM_NCCREATENachrichten , WM_CREATE, WM_NCCALCSIZEund WM_GETMINMAXINFO die Nachrichten an das Listenfeld-Steuerelement.

Diese Nachrichten werden standardmäßig von den OnNcCreateFunktionen , OnCreate, , OnNcCalcSizeund OnGetMinMaxInfo Member in der CWnd Basisklasse behandelt. Um die Standardmäßige Nachrichtenbehandlung zu erweitern, leiten Sie eine Klasse ab CListBox, fügen Sie der neuen Klasse eine Nachrichtenzuordnung hinzu, und überschreiben Sie die vorherigen Nachrichtenhandler-Memberfunktionen. Überschreiben OnCreateSie z. B. die erforderliche Initialisierung für eine neue Klasse.

Wenden Sie die folgenden Fensterformatvorlagen auf ein Listenfeld-Steuerelement an.

WS_CHILD Immer
WS_VISIBLE Gewöhnlich
WS_DISABLED Selten
WS_VSCROLL So fügen Sie eine vertikale Bildlaufleiste hinzu
WS_HSCROLL So fügen Sie eine horizontale Bildlaufleiste hinzu
WS_GROUP So gruppieren Sie Steuerelemente
WS_TABSTOP So lassen Sie die Tabulatortaste für dieses Steuerelement zu

Beispiel

// pParentWnd is a pointer to the parent window.
m_myListBox.Create(WS_CHILD | WS_VISIBLE | LBS_STANDARD | WS_HSCROLL,
                   CRect(10, 10, 200, 200), pParentWnd, IDC_MYLISTBOX);

`CListBox::DeleteItem`

Wird vom Framework aufgerufen, wenn der Benutzer ein Element aus einem Besitzer-Draw-Objekt CListBox löscht oder das Listenfeld zerstört.

virtual void DeleteItem(LPDELETEITEMSTRUCT lpDeleteItemStruct);

Parameter

lpDeleteItemStruct
Ein langer Zeiger auf eine Windows-Struktur DELETEITEMSTRUCT , die Informationen zum gelöschten Element enthält.

Hinweise

Bei der Standardimplementierung dieser Funktion wird keine Aktion ausgeführt. Überschreiben Sie diese Funktion, um ein Listenfeld für Besitzer-Zeichnen nach Bedarf neu zu zeichnen.

Eine Beschreibung der Struktur finden Sie unter.See CWnd::OnDeleteItem for a description of the DELETEITEMSTRUCT structure.

Beispiel

// CMyODListBox is my owner-drawn list box derived from CListBox. This
// example simply frees the item's text. The list box control was created
// with the following code:
//   m_myODListBox.Create(
//      WS_CHILD|WS_VISIBLE|WS_BORDER|WS_HSCROLL|WS_VSCROLL|
//      LBS_SORT|LBS_MULTIPLESEL|LBS_OWNERDRAWVARIABLE|LBS_WANTKEYBOARDINPUT,
//      CRect(10,250,200,450), pParentWnd, IDC_MYODLISTBOX);
//
void CMyODListBox::DeleteItem(LPDELETEITEMSTRUCT lpDeleteItemStruct)
{
   ASSERT(lpDeleteItemStruct->CtlType == ODT_LISTBOX);
   LPVOID lpszText = (LPVOID)lpDeleteItemStruct->itemData;
   ASSERT(lpszText != NULL);

   free(lpszText);

   CListBox::DeleteItem(lpDeleteItemStruct);
}

`CListBox::DeleteString`

Löscht das Element in position nIndex aus dem Listenfeld.

int DeleteString(UINT nIndex);

Parameter

nIndex
Gibt den nullbasierten Index der zu löschenden Zeichenfolge an.

Rückgabewert

Eine Anzahl der Zeichenfolgen, die in der Liste verbleiben. Der Rückgabewert ist LB_ERR , wenn nIndex ein Index größer als die Anzahl der Elemente in der Liste ist.

Hinweise

Alle elemente, die jetzt folgen, nIndex bewegen sich um eine Position nach unten. Wenn z. B. ein Listenfeld zwei Elemente enthält, bewirkt das Löschen des ersten Elements, dass sich das verbleibende Element jetzt an der ersten Position befindet. nIndex=0 für das Element an der ersten Position.

Beispiel

// Delete every other item from the list box.
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   m_myListBox.DeleteString(i);
}

`CListBox::Dir`

Fügt eine Liste von Dateinamen, Laufwerken oder beides zu einem Listenfeld hinzu.

int Dir(
    UINT attr,
    LPCTSTR lpszWildCard);

Parameter

attr
Dabei kann es sich um eine beliebige Kombination der enum in CFile::GetStatus, oder eine beliebige Kombination der folgenden Werte handeln:

Wert	Bedeutung
0x0000	Die Datei kann ausgelesen oder in diese geschrieben werden.
0x0001	Datei kann gelesen, aber nicht in.
0x0002	Die Datei ist ausgeblendet und wird nicht in einer Verzeichnisauflistung angezeigt.
0x0004	Datei ist eine Systemdatei.
0x0010	Der durch `lpszWildCard` die Angabe angegebene Name gibt ein Verzeichnis an.
0x0020	Die Datei wurde archiviert.
0x4000	Schließen Sie alle Laufwerke ein, die dem namen entsprechen, der durch `lpszWildCard`.
0x8000	Exklusive Kennzeichnung. Wenn das exklusive Flag festgelegt ist, werden nur Dateien des angegebenen Typs aufgelistet. Andernfalls werden Dateien des angegebenen Typs zusätzlich zu "normalen" Dateien aufgeführt.

lpszWildCard
Verweist auf eine Dateispezifikationszeichenfolge. Die Zeichenfolge kann Wildcards enthalten (z. B. *.*).

Rückgabewert

Der nullbasierte Index des Nachnamens, der der Liste hinzugefügt wurde. Der Rückgabewert ist, wenn ein Fehler auftritt. Der Rückgabewert ist LB_ERR LB_ERRSPACE , wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolgen verfügbar ist.

Beispiel

// Add all the files and directories in the windows directory.
TCHAR lpszWinPath[MAX_PATH], lpszOldPath[MAX_PATH];
::GetWindowsDirectory(lpszWinPath, MAX_PATH);

::GetCurrentDirectory(MAX_PATH, lpszOldPath);
::SetCurrentDirectory(lpszWinPath);

m_myListBox.ResetContent();
m_myListBox.Dir(DDL_READWRITE | DDL_DIRECTORY, _T("*.*"));

::SetCurrentDirectory(lpszOldPath);

`CListBox::DrawItem`

Wird vom Framework aufgerufen, wenn sich ein visueller Aspekt eines Besitzer-Zeichnen-Listenfelds ändert.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parameter

lpDrawItemStruct
Ein langer Zeiger auf eine DRAWITEMSTRUCT Struktur, die Informationen zum erforderlichen Zeichnungstyp enthält.

Hinweise

Die itemAction Elemente itemState der DRAWITEMSTRUCT Struktur definieren die Zeichnungsaktion, die ausgeführt werden soll.

Standardmäßig führt diese Memberfunktion nichts aus. Überschreiben Sie diese Memberfunktion, um die Zeichnung für ein Besitzer-Draw-Objekt CListBox zu implementieren. Die Anwendung sollte alle GDI-Objekte (Graphics Device Interface) wiederherstellen, die für den angezeigten Kontext ausgewählt lpDrawItemStruct sind, bevor diese Memberfunktion beendet wird.

Eine Beschreibung der Struktur finden Sie unter.See CWnd::OnDrawItem for a description of the DRAWITEMSTRUCT structure.

Beispiel

// CMyODListBox is my owner-drawn list box derived from CListBox. This
// example draws an item's text centered vertically and horizontally. The
// list box control was created with the following code:
//   m_myODListBox.Create(
//      WS_CHILD|WS_VISIBLE|WS_BORDER|WS_HSCROLL|WS_VSCROLL|
//      LBS_SORT|LBS_MULTIPLESEL|LBS_OWNERDRAWVARIABLE|LBS_WANTKEYBOARDINPUT,
//      CRect(10,250,200,450), pParentWnd, IDC_MYODLISTBOX);
//
void CMyODListBox::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
   ASSERT(lpDrawItemStruct->CtlType == ODT_LISTBOX);
   LPCTSTR lpszText = (LPCTSTR)lpDrawItemStruct->itemData;
   ASSERT(lpszText != NULL);
   CDC dc;

   dc.Attach(lpDrawItemStruct->hDC);

   // Save these value to restore them when done drawing.
   COLORREF crOldTextColor = dc.GetTextColor();
   COLORREF crOldBkColor = dc.GetBkColor();

   // If this item is selected, set the background color
   // and the text color to appropriate values. Also, erase
   // rect by filling it with the background color.
   if ((lpDrawItemStruct->itemAction | ODA_SELECT) &&
       (lpDrawItemStruct->itemState & ODS_SELECTED))
   {
      dc.SetTextColor(::GetSysColor(COLOR_HIGHLIGHTTEXT));
      dc.SetBkColor(::GetSysColor(COLOR_HIGHLIGHT));
      dc.FillSolidRect(&lpDrawItemStruct->rcItem,
                       ::GetSysColor(COLOR_HIGHLIGHT));
   }
   else
   {
      dc.FillSolidRect(&lpDrawItemStruct->rcItem, crOldBkColor);
   }

   // If this item has the focus, draw a red frame around the
   // item's rect.
   if ((lpDrawItemStruct->itemAction | ODA_FOCUS) &&
       (lpDrawItemStruct->itemState & ODS_FOCUS))
   {
      CBrush br(RGB(255, 0, 0));
      dc.FrameRect(&lpDrawItemStruct->rcItem, &br);
   }

   // Draw the text.
   dc.DrawText(
       lpszText,
       (int)_tcslen(lpszText),
       &lpDrawItemStruct->rcItem,
       DT_CENTER | DT_SINGLELINE | DT_VCENTER);

   // Reset the background color and the text color back to their
   // original values.
   dc.SetTextColor(crOldTextColor);
   dc.SetBkColor(crOldBkColor);

   dc.Detach();
}

`CListBox::FindString`

Sucht die erste Zeichenfolge in einem Listenfeld, das das angegebene Präfix enthält, ohne die Listenfeldauswahl zu ändern.

int FindString(
    int nStartAfter,
    LPCTSTR lpszItem) const;

Parameter

nStartAfter
Enthält den nullbasierten Index des Elements, bevor das erste Element durchsucht werden soll. Wenn die Suche das Ende des Listenfelds erreicht, wird sie vom oberen Rand des Listenfelds zurück zum durch nStartAfterdie Liste angegebenen Element fortgesetzt. Wenn nStartAfter -1 ist, wird das gesamte Listenfeld von Anfang an durchsucht.

lpszItem
Verweist auf die mit Null beendete Zeichenfolge, die das präfix enthält, nach dem gesucht werden soll. Die Suche ist unabhängig, sodass diese Zeichenfolge eine beliebige Kombination aus Groß- und Kleinbuchstaben enthalten kann.

Rückgabewert

Der nullbasierte Index des übereinstimmenden Elements oder LB_ERR wenn die Suche nicht erfolgreich war.

Hinweise

Verwenden Sie die SelectString Memberfunktion, um eine Zeichenfolge zu suchen und auszuwählen.

Beispiel

// The string to match.
LPCTSTR lpszmyString = _T("item");

// Delete all items that begin with the specified string.
int nIndex = 0;
while ((nIndex = m_myListBox.FindString(nIndex, lpszmyString)) != LB_ERR)
{
   m_myListBox.DeleteString(nIndex);
}

`CListBox::FindStringExact`

Sucht die erste Listenfeldzeichenfolge, die der in lpszFind.

int FindStringExact(
    int nIndexStart,
    LPCTSTR lpszFind) const;

Parameter

nIndexStart
Gibt den nullbasierten Index des Elements an, bevor das erste Element durchsucht werden soll. Wenn die Suche das Ende des Listenfelds erreicht, wird sie vom oberen Rand des Listenfelds zurück zum durch nIndexStartdie Liste angegebenen Element fortgesetzt. Wenn nIndexStart -1 ist, wird das gesamte Listenfeld von Anfang an durchsucht.

lpszFind
Verweist auf die mit Null beendete Zeichenfolge, nach der gesucht werden soll. Diese Zeichenfolge kann einen vollständigen Dateinamen enthalten, einschließlich der Erweiterung. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet, sodass die Zeichenfolge eine beliebige Kombination aus Groß- und Kleinbuchstaben enthalten kann.

Rückgabewert

Der Index des übereinstimmenden Elements oder LB_ERR wenn die Suche nicht erfolgreich war.

Hinweise

Wenn das Listenfeld mit einem Besitzer-Zeichnen-Format erstellt wurde, aber ohne formatvorlage LBS_HASSTRINGS , versucht die FindStringExact Memberfunktion, den Doubleword-Wert mit dem Wert von lpszFind.

Beispiel

// The string to match.
LPCTSTR lpszmyString = _T("item string 3");

// Delete all items that exactly match the specified string.
int nIndex = 0;
while ((nIndex = m_myListBox.FindStringExact(nIndex, lpszmyString)) != LB_ERR)
{
   m_myListBox.DeleteString(nIndex);
}

`CListBox::GetAnchorIndex`

Ruft den nullbasierten Index des aktuellen Ankerelements im Listenfeld ab.

int GetAnchorIndex() const;

Rückgabewert

Der Index des aktuellen Ankerelements, falls erfolgreich; andernfalls LB_ERR.

Hinweise

In einem Listenfeld mit Mehrfachauswahl ist das Ankerelement das erste oder letzte Element in einem Block zusammenhängender ausgewählter Elemente.

Beispiel

Ein Beispiel hierfür finden Sie unter CListBox::SetAnchorIndex.

`CListBox::GetCaretIndex`

Bestimmt den Index des Elements, das das Fokusrechteck in einem Listenfeld mit Mehrfachauswahl aufweist.

int GetCaretIndex() const;

Rückgabewert

Der nullbasierte Index des Elements, das das Fokusrechteck in einem Listenfeld enthält. Wenn es sich bei dem Listenfeld um ein Listenfeld mit einer Auswahl handelt, ist der Rückgabewert der Index des ausgewählten Elements, falls vorhanden.

Hinweise

Das Element kann ausgewählt oder nicht ausgewählt werden.

Beispiel

Ein Beispiel hierfür finden Sie unter CListBox::SetCaretIndex.

`CListBox::GetCount`

Ruft die Anzahl der Elemente in einem Listenfeld ab.

int GetCount() const;

Rückgabewert

Die Anzahl der Elemente im Listenfeld oder LB_ERR wenn ein Fehler auftritt.

Hinweise

Die zurückgegebene Anzahl ist eine größer als der Indexwert des letzten Elements (der Index ist nullbasiert).

Beispiel

// Add 10 items to the list box.
CString str;
for (int i = 0; i < 10; i++)
{
   str.Format(_T("item %d"), i);
   m_myListBox.AddString(str);
}

// Verify that 10 items were added to the list box.
ASSERT(m_myListBox.GetCount() == 10);

`CListBox::GetCurSel`

Ruft den nullbasierten Index des aktuell ausgewählten Elements (sofern vorhanden) in einem Listenfeld mit einer Auswahl ab.

int GetCurSel() const;

Rückgabewert

Der nullbasierte Index des aktuell ausgewählten Elements, wenn es sich um ein Listenfeld mit einer Auswahl handelt. LB_ERR Wenn derzeit kein Element ausgewählt ist.

In einem Listenfeld mit Mehrfachauswahl wird der Index des Elements mit dem Fokus angezeigt.

Hinweise

Rufen Sie GetCurSel kein Listenfeld für Mehrfachauswahl auf. Verwenden Sie stattdessen CListBox::GetSelItems.

Beispiel

// Select the next item of the currently selected one.
int nIndex = m_myListBox.GetCurSel();
int nCount = m_myListBox.GetCount();
if ((nIndex != LB_ERR) && (nCount > 1))
{
   if (++nIndex < nCount)
      m_myListBox.SetCurSel(nIndex);
   else
      m_myListBox.SetCurSel(0);
}

`CListBox::GetHorizontalExtent`

Ruft aus dem Listenfeld die Breite in Pixeln ab, um die es horizontal gescrollt werden kann.

int GetHorizontalExtent() const;

Rückgabewert

Die bildlauffähige Breite des Listenfelds in Pixel.

Hinweise

Dies gilt nur, wenn das Listenfeld über eine horizontale Bildlaufleiste verfügt.

Beispiel

// Find the longest string in the list box.
CString str;
CSize sz;
int dx = 0;
CDC *pDC = m_myListBox.GetDC();
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   m_myListBox.GetText(i, str);
   sz = pDC->GetTextExtent(str);

   if (sz.cx > dx)
      dx = sz.cx;
}
m_myListBox.ReleaseDC(pDC);

// Set the horizontal extent only if the current extent is not large enough.
if (m_myListBox.GetHorizontalExtent() < dx)
{
   m_myListBox.SetHorizontalExtent(dx);
   ASSERT(m_myListBox.GetHorizontalExtent() == dx);
}

`CListBox::GetItemData`

Ruft den vom Anwendung bereitgestellten Doubleword-Wert ab, der dem angegebenen Listenfeldelement zugeordnet ist.

DWORD_PTR GetItemData(int nIndex) const;

Parameter

nIndex
Gibt den nullbasierten Index des Elements im Listenfeld an.

Rückgabewert

Der dem Element zugeordnete Wert oder LB_ERR wenn ein Fehler auftritt.

Hinweise

Der Doubleword-Wert war der dwItemData Parameter eines Aufrufs SetItemData .

Beispiel

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

`CListBox::GetItemDataPtr`

Ruft den vom Anwendung bereitgestellten 32-Bit-Wert ab, der dem angegebenen Listenfeldelement als Zeiger (void *) zugeordnet ist.

void* GetItemDataPtr(int nIndex) const;

Parameter

nIndex
Gibt den nullbasierten Index des Elements im Listenfeld an.

Rückgabewert

Ruft einen Zeiger oder -1 ab, wenn ein Fehler auftritt.

Beispiel

LPVOID lpmyPtr = pParentWnd;

// Check all the items in the list box; if an item's
// data pointer is equal to my pointer then reset it to NULL.
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   if (m_myListBox.GetItemDataPtr(i) == lpmyPtr)
   {
      m_myListBox.SetItemDataPtr(i, NULL);
   }
}

`CListBox::GetItemHeight`

Bestimmt die Höhe von Elementen in einem Listenfeld.

int GetItemHeight(int nIndex) const;

Parameter

nIndex
Gibt den nullbasierten Index des Elements im Listenfeld an. Dieser Parameter wird nur verwendet, wenn das Listenfeld die LBS_OWNERDRAWVARIABLE Formatvorlage aufweist. Andernfalls sollte er auf 0 festgelegt werden.

Rückgabewert

Die Höhe der Elemente im Listenfeld in Pixel. Wenn das Listenfeld die LBS_OWNERDRAWVARIABLE Formatvorlage aufweist, ist der Rückgabewert die Höhe des durch nIndex. Wenn ein Fehler auftritt, lautet LB_ERRder Rückgabewert .

Beispiel

// Set the height of every item so the item
// is completely visible.
CString str;
CSize sz;
CDC *pDC = m_myListBox.GetDC();
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   m_myListBox.GetText(i, str);
   sz = pDC->GetTextExtent(str);

   // Only want to set the item height if the current height
   // is not big enough.
   if (m_myListBox.GetItemHeight(i) < sz.cy)
      m_myListBox.SetItemHeight(i, sz.cy);
}
m_myListBox.ReleaseDC(pDC);

`CListBox::GetItemRect`

Ruft die Abmessungen des Rechtecks ab, das ein Listenfeldelement begrenzt, wie es derzeit im Listenfeldfenster angezeigt wird.

int GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parameter

nIndex
Gibt den nullbasierten Index des Elements an.

lpRect
Gibt einen langen Zeiger auf eine RECT Struktur an, die die Clientkoordinaten des Listenfelds des Elements empfängt.

Rückgabewert

LB_ERR wenn ein Fehler auftritt.

Beispiel

// Dump all of the items bounds.
CString str;
RECT r;
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   m_myListBox.GetItemRect(i, &r);

   str.Format(_T("item %d: left = %d, top = %d, right = %d, ")
              _T("bottom = %d\r\n"),
              i,
              r.left,
              r.top,
              r.right,
              r.bottom);
   AFXDUMP(str);
}

`CListBox::GetListBoxInfo`

Ruft die Anzahl der Elemente pro Spalte ab.

DWORD GetListBoxInfo() const;

Rückgabewert

Anzahl der Elemente pro Spalte des CListBox Objekts.

Hinweise

Diese Memberfunktion emuliert die Funktionalität der LB_GETLISTBOXINFO Nachricht, wie im Windows SDK beschrieben.

`CListBox::GetLocale`

Ruft das gebietsschema ab, das vom Listenfeld verwendet wird.

LCID GetLocale() const;

Rückgabewert

Der Gebietsschemabezeichnerwert (LCID) für die Zeichenfolgen im Listenfeld.

Hinweise

Das Gebietsschema wird beispielsweise verwendet, um die Sortierreihenfolge der Zeichenfolgen in einem sortierten Listenfeld zu bestimmen.

Beispiel

Ein Beispiel hierfür finden Sie unter CListBox::SetLocale.

`CListBox::GetSel`

Ruft den Auswahlstatus eines Elements ab.

int GetSel(int nIndex) const;

Parameter

nIndex
Gibt den nullbasierten Index des Elements an.

Rückgabewert

Eine positive Zahl, wenn das angegebene Element ausgewählt ist; andernfalls ist es 0. Der Rückgabewert ist LB_ERR , wenn ein Fehler auftritt.

Hinweise

Diese Memberfunktion funktioniert sowohl mit Listenfeldern mit einfacher als auch mit mehrfacher Auswahl.

Um den Index des aktuell ausgewählten Listenfeldelements abzurufen, verwenden Sie CListBox::GetCurSel.

Beispiel

// Dump all of the items select state.
CString str;
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   str.Format(_T("item %d: select state is %s\r\n"),
              i,
              m_myListBox.GetSel(i) > 0 ? _T("true") : _T("false"));
   AFXDUMP(str);
}

`CListBox::GetSelCount`

Ruft die Gesamtanzahl der ausgewählten Elemente in einem Listenfeld mit Mehrfachauswahl ab.

int GetSelCount() const;

Rückgabewert

Die Anzahl der ausgewählten Elemente in einem Listenfeld. Wenn das Listenfeld ein Listenfeld mit einer Auswahl ist, lautet LB_ERRder Rückgabewert .

Beispiel

Ein Beispiel hierfür finden Sie unter CListBox::GetSelItems.

`CListBox::GetSelItems`

Füllt einen Puffer mit einem Array ganzzahliger Zahlen, die die Elementnummern ausgewählter Elemente in einem Listenfeld mit Mehrfachauswahl angibt.

int GetSelItems(
    int nMaxItems,
    LPINT rgIndex) const;

Parameter

nMaxItems
Gibt die maximale Anzahl der ausgewählten Elemente an, deren Elementnummern im Puffer platziert werden sollen.

rgIndex
Gibt einen Zeiger auf einen Puffer an, der groß genug für die Anzahl der ganzzahligen Zahlen ist, die durch nMaxItems.

Rückgabewert

Die tatsächliche Anzahl der Im Puffer platzierten Elemente. Wenn das Listenfeld ein Listenfeld mit einer Auswahl ist, lautet LB_ERRder Rückgabewert .

Beispiel

// Get the indexes of all the selected items.
int nCount = m_myODListBox.GetSelCount();
CArray<int, int> aryListBoxSel;

aryListBoxSel.SetSize(nCount);
m_myODListBox.GetSelItems(nCount, aryListBoxSel.GetData());

// Dump the selection array.
AFXDUMP(aryListBoxSel);

`CListBox::GetText`

Ruft eine Zeichenfolge aus einem Listenfeld ab.

int GetText(
    int nIndex,
    LPTSTR lpszBuffer) const;

void GetText(
    int nIndex,
    CString& rString) const;

Parameter

nIndex
Gibt den nullbasierten Index der abzurufenden Zeichenfolge an.

lpszBuffer
Verweist auf den Puffer, der die Zeichenfolge empfängt. Der Puffer muss über ausreichend Speicherplatz für die Zeichenfolge und ein endendes NULL-Zeichen verfügen. Die Größe der Zeichenfolge kann vorab durch Aufrufen der GetTextLen Memberfunktion bestimmt werden.

rString
Ein Verweis auf ein CString-Objekt.

Rückgabewert

Die Länge (in Byte) der Zeichenfolge, mit Ausnahme des endenden Nullzeichens. Wenn nIndex kein gültiger Index angegeben wird, lautet LB_ERRder Rückgabewert .

Hinweise

Die zweite Form dieser Memberfunktion füllt ein CString Objekt mit dem Zeichenfolgentext aus.

Beispiel

// Dump all of the items in the list box.
CString str, str2;
int n;
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   n = m_myListBox.GetTextLen(i);
   m_myListBox.GetText(i, str.GetBuffer(n));
   str.ReleaseBuffer();

   str2.Format(_T("item %d: %s\r\n"), i, str.GetBuffer(0));
   AFXDUMP(str2);
}

`CListBox::GetTextLen`

Ruft die Länge einer Zeichenfolge in einem Listenfeldelement ab.

int GetTextLen(int nIndex) const;

Parameter

nIndex
Gibt den nullbasierten Index der Zeichenfolge an.

Rückgabewert

Die Länge der Zeichenfolge in Zeichen, mit Ausnahme des endenden Nullzeichens. Wenn nIndex kein gültiger Index angegeben wird, lautet LB_ERRder Rückgabewert .

Beispiel

Ein Beispiel hierfür finden Sie unter CListBox::GetText.

`CListBox::GetTopIndex`

Ruft den nullbasierten Index des ersten sichtbaren Elements in einem Listenfeld ab.

int GetTopIndex() const;

Rückgabewert

Der nullbasierte Index des ersten sichtbaren Elements in einem Listenfeld, falls erfolgreich, LB_ERR andernfalls.

Hinweise

Anfangs befindet sich Element 0 am Anfang des Listenfelds, aber wenn das Listenfeld gescrollt wird, befindet sich möglicherweise ein weiteres Element oben.

Beispiel

// Want an item in the bottom half to be the first visible item.
int n = m_myListBox.GetCount() / 2;
if (m_myListBox.GetTopIndex() < n)
{
   m_myListBox.SetTopIndex(n);
   ASSERT(m_myListBox.GetTopIndex() == n);
}

`CListBox::InitStorage`

Ordnet Speicher zum Speichern von Listenfeldelementen zu.

int InitStorage(
    int nItems,
    UINT nBytes);

Parameter

nItems
Gibt die Anzahl der hinzuzufügenden Elemente an.

nBytes
Gibt die Speichermenge in Bytes an, die für Elementzeichenfolgen zugewiesen werden soll.

Rückgabewert

Bei erfolgreicher Ausführung kann die maximale Anzahl von Elementen, die im Listenfeld gespeichert werden können, bevor eine Speicherinteilung erforderlich ist, andernfalls LB_ERRSPACEist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Rufen Sie diese Funktion auf, bevor Sie einer großen Anzahl von Elementen hinzufügen CListBox.

Diese Funktion beschleunigt die Initialisierung von Listenfeldern mit einer großen Anzahl von Elementen (mehr als 100). Es wird die angegebene Speichermenge vorverteilt, sodass nachfolgende AddString, InsertStringund Dir Funktionen die kürzeste Zeit in Anspruch nehmen. Sie können Schätzungen für die Parameter verwenden. Wenn Sie die Überschätzung überschätzen, werden zusätzlichen Arbeitsspeicher zugewiesen. wenn Sie unterschätzen, wird die normale Zuordnung für Elemente verwendet, die den vorallocated-Betrag überschreiten.

Nur Windows 95/98: Der nItems Parameter ist auf 16-Bit-Werte beschränkt. Dies bedeutet, dass Listenfelder nicht mehr als 32.767 Elemente enthalten dürfen. Obwohl die Anzahl der Elemente eingeschränkt ist, ist die Gesamtgröße der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

Beispiel

// Initialize the storage of the list box to be 256 strings with
// about 10 characters per string, performance improvement.
int n = m_myListBox.InitStorage(256, 16 * sizeof(TCHAR));
ASSERT(n != LB_ERRSPACE);

// Add 256 items to the list box.
CString str;
for (int i = 0; i < 256; i++)
{
   str.Format(_T("item string %d"), i);
   m_myListBox.AddString(str);
}

`CListBox::InsertString`

Fügt eine Zeichenfolge in das Listenfeld ein.

int InsertString(
    int nIndex,
    LPCTSTR lpszItem);

Parameter

nIndex
Gibt den nullbasierten Index der Position an, an der die Zeichenfolge eingefügt werden soll. Wenn dieser Parameter -1 ist, wird die Zeichenfolge am Ende der Liste hinzugefügt.

lpszItem
Zeigt auf die einzufügende nullterminierte Zeichenfolge.

Rückgabewert

Der nullbasierte Index der Position, an der die Zeichenfolge eingefügt wurde. Der Rückgabewert ist, wenn ein Fehler auftritt. Der Rückgabewert ist LB_ERR LB_ERRSPACE , wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolge verfügbar ist.

Hinweise

AddString Im Gegensatz zur Memberfunktion InsertString wird keine Liste mit der LBS_SORT Formatvorlage sortiert.

Beispiel

// Insert items in between existing items.
CString str;
int n = m_myListBox.GetCount();
for (int i = 0; i < n; i++)
{
   str.Format(_T("item string %c"), (char)('A' + i));
   m_myListBox.InsertString(2 * i, str);
}

`CListBox::ItemFromPoint`

Bestimmt das Listenfeldelement, das dem in der Datei ptangegebenen Punkt am nächsten liegt.

UINT ItemFromPoint(
    CPoint pt,
    BOOL& bOutside) const;

Parameter

pt
Punkt, für den das nächste Element gefunden werden soll, angegeben relativ zur oberen linken Ecke des Clientbereichs des Listenfelds.

bOutside
Verweis auf eine BOOL Variable, die festgelegt TRUE wird, wenn pt sich außerhalb des Clientbereichs des Listenfelds befindet, FALSE wenn pt sich der Clientbereich des Listenfelds befindet.

Rückgabewert

Der Index des nächstgelegenen Elements zum angegebenen ptPunkt.

Hinweise

Mit dieser Funktion können Sie bestimmen, welches Listenfeldelement der Mauszeiger bewegt.

Beispiel

Ein Beispiel hierfür finden Sie unter CListBox::SetAnchorIndex.

`CListBox::MeasureItem`

Wird vom Framework aufgerufen, wenn ein Listenfeld mit einem Besitzer-Zeichnen-Format erstellt wird.

virtual void MeasureItem(LPMEASUREITEMSTRUCT lpMeasureItemStruct);

Parameter

lpMeasureItemStruct
Ein langer Zeiger auf eine MEASUREITEMSTRUCT Struktur.

Hinweise

Standardmäßig führt diese Memberfunktion nichts aus. Überschreiben Sie diese Memberfunktion, und füllen Sie die MEASUREITEMSTRUCT Struktur aus, um Windows über die Abmessungen des Listenfelds zu informieren. Wenn das Listenfeld mit der LBS_OWNERDRAWVARIABLE Formatvorlage erstellt wird, ruft das Framework diese Memberfunktion für jedes Element im Listenfeld auf. Andernfalls wird dieses Element nur einmal aufgerufen.

Weitere Informationen zur Verwendung des LBS_OWNERDRAWFIXED Stils in einem Listenfeld mit Besitzer-Zeichnen, das mit der SubclassDlgItem Memberfunktion CWnderstellt wurde, finden Sie in der Diskussion in Technical Note 14.

Eine Beschreibung der Struktur finden Sie unter.See CWnd::OnMeasureItem for a description of the MEASUREITEMSTRUCT structure.

Beispiel

// CMyODListBox is my owner-drawn list box derived from CListBox. This
// example measures an item and sets the height of the item to twice the
// vertical extent of its text. The list box control was created with the
// following code:
//   m_myODListBox.Create(
//      WS_CHILD|WS_VISIBLE|WS_BORDER|WS_HSCROLL|WS_VSCROLL|
//      LBS_SORT|LBS_MULTIPLESEL|LBS_OWNERDRAWVARIABLE|LBS_WANTKEYBOARDINPUT,
//      CRect(10,250,200,450), pParentWnd, IDC_MYODLISTBOX);
//
void CMyODListBox::MeasureItem(LPMEASUREITEMSTRUCT lpMeasureItemStruct)
{
   ASSERT(lpMeasureItemStruct->CtlType == ODT_LISTBOX);
   LPCTSTR lpszText = (LPCTSTR)lpMeasureItemStruct->itemData;
   ASSERT(lpszText != NULL);
   CSize sz;
   CDC *pDC = GetDC();

   sz = pDC->GetTextExtent(lpszText);

   ReleaseDC(pDC);

   lpMeasureItemStruct->itemHeight = 2 * sz.cy;
}

`CListBox::ResetContent`

Entfernt alle Elemente aus einem Listenfeld.

void ResetContent();

Beispiel

// Delete all the items from the list box.
m_myListBox.ResetContent();
ASSERT(m_myListBox.GetCount() == 0);

`CListBox::SelectString`

Sucht nach einem Listenfeldelement, das der angegebenen Zeichenfolge entspricht, und wenn ein übereinstimmende Element gefunden wird, wird das Element ausgewählt.

int SelectString(
    int nStartAfter,
    LPCTSTR lpszItem);

Parameter

Rückgabewert

Der Index des ausgewählten Elements, wenn die Suche erfolgreich war. Wenn die Suche nicht erfolgreich war, lautet LB_ERR der Rückgabewert und die aktuelle Auswahl wird nicht geändert.

Hinweise

Das Listenfeld wird bei Bedarf gescrollt, um das ausgewählte Element in die Ansicht zu bringen.

Diese Memberfunktion kann nicht mit einem Listenfeld verwendet werden, das die LBS_MULTIPLESEL Formatvorlage aufweist.

Ein Element wird nur ausgewählt, wenn die Anfangszeichen (vom Anfangspunkt) mit den Zeichen in der Zeichenfolge übereinstimmen, die durch lpszItem.

Verwenden Sie die FindString Memberfunktion, um eine Zeichenfolge zu finden, ohne das Element auszuwählen.

Beispiel

// The string to match.
LPCTSTR lpszmyString = _T("item 5");

// Select the item that begins with the specified string.
int nIndex = m_myListBox.SelectString(0, lpszmyString);
ASSERT(nIndex != LB_ERR);

`CListBox::SelItemRange`

Markiert mehrere aufeinander folgende Elemente in einem Listenfeld mit mehrfacher Auswahl.

int SelItemRange(
    BOOL bSelect,
    int nFirstItem,
    int nLastItem);

Parameter

bSelect
Gibt an, wie die Auswahl festgelegt wird. Wenn ja, wird TRUEdie Zeichenfolge ausgewählt und hervorgehoben. WennFALSEbSelect, wird die Hervorhebung entfernt, und die Zeichenfolge wird nicht mehr ausgewählt.

nFirstItem
Gibt den nullbasierten Index des ersten festzulegenden Elements an.

nLastItem
Gibt den nullbasierten Index des letzten festzulegenden Elements an.

Rückgabewert

LB_ERR wenn ein Fehler auftritt.

Hinweise

Verwenden Sie diese Memberfunktion nur für Listenfelder mit mehrfacher Auswahl. Wenn Sie nur ein Element in einem Listenfeld mit mehrfacher Auswahl auswählen müssen , d. h. falls nFirstItem gleich nLastItem , rufen Sie stattdessen die SetSel Memberfunktion auf.

Beispiel

// Select half of the items.
m_myODListBox.SelItemRange(TRUE, 0, m_myODListBox.GetCount() / 2);

`CListBox::SetAnchorIndex`

Legt den Anker in einem Listenfeld für Mehrfachauswahl fest, um eine erweiterte Auswahl zu beginnen.

void SetAnchorIndex(int nIndex);

Parameter

nIndex
Gibt den nullbasierten Index des Listenfeldelements an, das der Anker ist.

Hinweise

In einem Listenfeld mit Mehrfachauswahl ist das Ankerelement das erste oder letzte Element in einem Block zusammenhängender ausgewählter Elemente.

Beispiel

void CMyODListBox::OnLButtonDown(UINT nFlags, CPoint point)
{
   BOOL bOutside = TRUE;
   UINT uItem = ItemFromPoint(point, bOutside);

   if (!bOutside)
   {
      // Set the anchor to be the middle item.
      SetAnchorIndex(uItem);
      ASSERT((UINT)GetAnchorIndex() == uItem);
   }

   CListBox::OnLButtonDown(nFlags, point);
}

`CListBox::SetCaretIndex`

Legt das Fokusrechteck auf das Element am angegebenen Index in einem Listenfeld mit Mehrfachauswahl fest.

int SetCaretIndex(
    int nIndex,
    BOOL bScroll = TRUE);

Parameter

nIndex
Gibt den nullbasierten Index des Elements an, um das Fokusrechteck im Listenfeld zu erhalten.

bScroll
Wenn dieser Wert 0 ist, wird das Element so lange gescrollt, bis es vollständig sichtbar ist. Wenn dieser Wert nicht 0 ist, wird das Element scrollen, bis es mindestens teilweise sichtbar ist.

Rückgabewert

LB_ERR wenn ein Fehler auftritt.

Hinweise

Wenn das Element nicht sichtbar ist, wird es in die Ansicht gescrollt.

Beispiel

// Set the caret to be the middle item.
m_myListBox.SetCaretIndex(m_myListBox.GetCount() / 2);
ASSERT(m_myListBox.GetCaretIndex() == m_myListBox.GetCount() / 2);

`CListBox::SetColumnWidth`

Legt die Breite in Pixeln aller Spalten in einem mehrspaltigen Listenfeld fest (erstellt mit der LBS_MULTICOLUMN Formatvorlage).

void SetColumnWidth(int cxWidth);

Parameter

cxWidth
Gibt die Breite in Pixeln aller Spalten an.

Beispiel

// Find the pixel width of the largest item.
CString str;
CSize   sz;
int     dx = 0;
CDC* pDC = myListBox.GetDC();
for (int i = 0; i < myListBox.GetCount(); i++)
{
   myListBox.GetText(i, str);
   sz = pDC->GetTextExtent(str);

   if (sz.cx > dx)
      dx = sz.cx;
}
myListBox.ReleaseDC(pDC);

// Set the column width of the first column to be one and 1/3 units
// of the largest string. 
myListBox.SetColumnWidth(dx * 4 / 3);

`CListBox::SetCurSel`

Wählt eine Zeichenfolge aus und scrollt bei Bedarf in die Ansicht.

int SetCurSel(int nSelect);

Parameter

nSelect
Gibt den nullbasierten Index der Zeichenfolge an, die ausgewählt werden soll. Wenn nSelect -1 ist, ist das Listenfeld so eingestellt, dass keine Auswahl vorhanden ist.

Rückgabewert

LB_ERR wenn ein Fehler auftritt.

Hinweise

Wenn die neue Zeichenfolge ausgewählt ist, entfernt das Listenfeld die Hervorhebung aus der zuvor ausgewählten Zeichenfolge.

Verwenden Sie diese Memberfunktion nur für Listenfelder mit einer Auswahl.

Um eine Auswahl in einem Listenfeld mit mehrfacher Auswahl festzulegen oder zu entfernen, verwenden Sie CListBox::SetSel.

Beispiel

// Select the last item in the list box.
int nCount = m_myListBox.GetCount();
if (nCount > 0)
   m_myListBox.SetCurSel(nCount - 1);

`CListBox::SetHorizontalExtent`

Legt die Breite in Pixel fest, um die ein Listenfeld horizontal gescrollt werden kann.

void SetHorizontalExtent(int cxExtent);

Parameter

cxExtent
Gibt die Anzahl der Pixel an, um die das Listenfeld horizontal scrollen kann.

Hinweise

Wenn die Größe des Listenfelds kleiner als dieser Wert ist, führt die horizontale Bildlaufleiste einen horizontalen Bildlauf durch Elemente im Listenfeld aus. Wenn das Listenfeld so groß oder größer als dieser Wert ist, wird die horizontale Bildlaufleiste ausgeblendet.

Um auf einen Aufruf SetHorizontalExtentzu reagieren, muss das Listenfeld mit der WS_HSCROLL Formatvorlage definiert worden sein.

Diese Memberfunktion ist für mehrspaltige Listenfelder nicht nützlich. Rufen Sie für mehrspaltige Listenfelder die SetColumnWidth Memberfunktion auf.

Beispiel

// Find the longest string in the list box.
CString str;
CSize sz;
int dx = 0;
TEXTMETRIC tm;
CDC *pDC = m_myListBox.GetDC();
CFont *pFont = m_myListBox.GetFont();

// Select the listbox font, save the old font
CFont *pOldFont = pDC->SelectObject(pFont);
// Get the text metrics for avg char width
pDC->GetTextMetrics(&tm);

for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   m_myListBox.GetText(i, str);
   sz = pDC->GetTextExtent(str);

   // Add the avg width to prevent clipping
   sz.cx += tm.tmAveCharWidth;

   if (sz.cx > dx)
      dx = sz.cx;
}
// Select the old font back into the DC
pDC->SelectObject(pOldFont);
m_myListBox.ReleaseDC(pDC);

// Set the horizontal extent so every character of all strings
// can be scrolled to.
m_myListBox.SetHorizontalExtent(dx);

`CListBox::SetItemData`

Legt einen Wert fest, der dem angegebenen Element in einem Listenfeld zugeordnet ist.

int SetItemData(
    int nIndex,
    DWORD_PTR dwItemData);

Parameter

nIndex
Gibt den nullbasierten Index des Elements an.

dwItemData
Gibt den Wert an, der dem Element zugeordnet werden soll.

Rückgabewert

LB_ERR wenn ein Fehler auftritt.

Beispiel

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

`CListBox::SetItemDataPtr`

Legt den dem angegebenen Element in einem Listenfeld zugeordneten 32-Bit-Wert auf den angegebenen Zeiger ( void *) fest.

int SetItemDataPtr(
    int nIndex,
    void* pData);

Parameter

nIndex
Gibt den nullbasierten Index des Elements an.

pData
Gibt den Zeiger an, der dem Element zugeordnet werden soll.

Rückgabewert

LB_ERR wenn ein Fehler auftritt.

Hinweise

Dieser Zeiger bleibt gültig für die Lebensdauer des Listenfelds, auch wenn sich die relative Position des Elements innerhalb des Listenfelds ändern kann, wenn Elemente hinzugefügt oder entfernt werden. Daher kann sich der Index des Elements innerhalb des Felds ändern, aber der Zeiger bleibt zuverlässig.

Beispiel

// Set the data pointer of each item to be NULL.
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   m_myListBox.SetItemDataPtr(i, NULL);
}

`CListBox::SetItemHeight`

Legt die Höhe von Elementen in einem Listenfeld fest.

int SetItemHeight(
    int nIndex,
    UINT cyItemHeight);

Parameter

cyItemHeight
Gibt die Höhe des Elements in Pixel an.

Rückgabewert

LB_ERR wenn der Index oder die Höhe ungültig ist.

Hinweise

Wenn das Listenfeld die LBS_OWNERDRAWVARIABLE Formatvorlage aufweist, legt diese Funktion die Höhe des durch nIndex. Andernfalls legt diese Funktion die Höhe aller Elemente im Listenfeld fest.

Beispiel

// Set the height of every item to be the
// vertical size of the item's text extent.
CString str;
CSize sz;
CDC *pDC = myListBox.GetDC();
for (int i = 0; i < myListBox.GetCount(); i++)
{
   myListBox.GetText(i, str);
   sz = pDC->GetTextExtent(str);

   myListBox.SetItemHeight(i, sz.cy);
}
myListBox.ReleaseDC(pDC);

`CListBox::SetLocale`

Legt den Gebietsschemabezeichner für dieses Listenfeld fest.

LCID SetLocale(LCID nNewLocale);

Parameter

nNewLocale
Der neue LCID-Wert (Locale Identifier), der für das Listenfeld festgelegt werden soll.

Rückgabewert

Der vorherige Gebietsschemabezeichnerwert (LCID) für dieses Listenfeld.

Hinweise

Wird SetLocale das Standardgebietsschema nicht aufgerufen, wird das Standardgebietsschema vom System abgerufen. Dieses Systemstandardgebietsschema kann mithilfe der regionalen (oder internationalen) Anwendung Systemsteuerung geändert werden.

Beispiel

// My LCID to use.
LCID mylcid = MAKELCID(MAKELANGID(LANG_SPANISH, SUBLANG_SPANISH_MEXICAN),
                       SORT_DEFAULT);

// Force the list box to use my locale.
m_myListBox.SetLocale(mylcid);
ASSERT(m_myListBox.GetLocale() == mylcid);

`CListBox::SetSel`

Wählt eine Zeichenfolge in einem Listenfeld mit mehrfacher Auswahl aus.

int SetSel(
    int nIndex,
    BOOL bSelect = TRUE);

Parameter

nIndex
Enthält den nullbasierten Index der festzulegenden Zeichenfolge. Wenn -1, wird die Auswahl je nach Wert bSelectvon allen Zeichenfolgen zu allen Zeichenfolgen hinzugefügt oder daraus entfernt.

Rückgabewert

LB_ERR wenn ein Fehler auftritt.

Hinweise

Verwenden Sie diese Memberfunktion nur für Listenfelder mit mehrfacher Auswahl.

Um ein Element aus einem Listenfeld mit einer Auswahl auszuwählen, verwenden Sie CListBox::SetCurSel.

Beispiel

// Select all of the items with an even index and
// deselect all others.
for (int i = 0; i < m_myODListBox.GetCount(); i++)
{
   m_myODListBox.SetSel(i, ((i % 2) == 0));
}

`CListBox::SetTabStops`

Legt die Tabstopppositionen in einem Listenfeld fest.

void SetTabStops();
BOOL SetTabStops(const int& cxEachStop);

BOOL SetTabStops(
    int nTabStops,
    LPINT rgTabStops);

Parameter

cxEachStop
Tabstopps werden bei allen cxEachStop Dialogfeldeinheiten festgelegt. Eine Beschreibung einer Dialogeinheit finden Sie unter.See rgTabStops for a description of a dialog unit.

nTabStops
Gibt die Anzahl der Tabstopps an, die im Listenfeld enthalten sein sollen.

rgTabStops
Zeigt auf das erste Element eines Arrays ganzzahliger Zahlen, die die Tabstopppositionen in Dialogfeldeinheiten enthalten. Eine Dialogeinheit ist ein horizontaler oder vertikaler Abstand. Eine horizontale Dialogeinheit ist gleich 14 der aktuellen Basisbreiteneinheit des Dialogfelds, und eine vertikale Dialogeinheit entspricht einer Achtel der aktuellen Dialogbasishöheneinheit. Die Dialogbasiseinheiten werden basierend auf der Höhe und Breite der aktuellen Systemschriftart berechnet. Die GetDialogBaseUnits Windows-Funktion gibt die aktuellen Dialogbasiseinheiten in Pixeln zurück. Die Tabstopps müssen in zunehmender Reihenfolge sortiert werden. Zurück-Registerkarten sind nicht zulässig.

Rückgabewert

Nonzero, wenn alle Registerkarten festgelegt wurden; andernfalls 0.

Hinweise

Um Tabstopps auf die Standardgröße von 2 Dialogeinheiten festzulegen, rufen Sie die parameterlose Version dieser Memberfunktion auf. Um Tabstopps auf eine andere Größe als 2 festzulegen, rufen Sie die Version mit dem cxEachStop Argument auf.

Wenn Sie Tabstopps auf ein Array von Größen festlegen möchten, verwenden Sie die Version mit den rgTabStops Und-Argumenten nTabStops . Ein Tabstopp wird für jeden Wert in rgTabStops, bis zur durch nTabStops.

Um auf einen Aufruf der SetTabStops Memberfunktion zu reagieren, muss das Listenfeld mit der LBS_USETABSTOPS Formatvorlage erstellt worden sein.

Beispiel

// Find the pixel width of the largest first substring.
CString str;
CSize sz;
int nIndex, dx = 0;
CDC *pDC = myListBox.GetDC();
for (int i = 0; i < myListBox.GetCount(); i++)
{
   myListBox.GetText(i, str);

   if ((nIndex = str.Find('\t')) != -1)
      str = str.Right(nIndex);

   sz = pDC->GetTextExtent(str);

   if (sz.cx > dx)
      dx = sz.cx;
}
myListBox.ReleaseDC(pDC);

// Set tab stops at every one and 1/3 units
// of the largest string.
// NOTE: Convert pixels to dialog units.
myListBox.SetTabStops((dx * 4 / 3 * 4) / LOWORD(::GetDialogBaseUnits()));

`CListBox::SetTopIndex`

Stellt sicher, dass ein bestimmtes Listenfeldelement sichtbar ist.

int SetTopIndex(int nIndex);

Parameter

nIndex
Gibt den nullbasierten Index des Listenfeldelements an.

Rückgabewert

Null bei erfolgreicher Ausführung oder LB_ERR wenn ein Fehler auftritt.

Hinweise

Das System scrollt das Listenfeld, bis entweder das durch nIndex das angegebene Element oben im Listenfeld angezeigt wird oder der maximale Bildlaufbereich erreicht wurde.

Beispiel

// Set the first visible item in the list box to be the middle item
m_myListBox.SetTopIndex(m_myListBox.GetCount() / 2);

`CListBox::VKeyToItem`

Wird vom Framework aufgerufen, wenn das übergeordnete Fenster des Listenfelds eine WM_VKEYTOITEM Nachricht aus dem Listenfeld empfängt.

virtual int VKeyToItem(
    UINT nKey,
    UINT nIndex);

Parameter

nKey
Der virtuelle Tastencode der Taste, die der Benutzer gedrückt hat. Eine Liste der standardmäßigen virtuellen Schlüsselcodes finden Sie unter Winuser.h

nIndex
Die aktuelle Position des Listenfeld-Caret.

Rückgabewert

Gibt - 2 für keine weitere Aktion, - 1 für Die Standardaktion oder eine nichtnegative Zahl, um einen Index eines Listenfeldelements anzugeben, für das die Standardaktion für den Tastenanschlag ausgeführt werden soll.

Hinweise

Die WM_VKEYTOITEM Nachricht wird vom Listenfeld gesendet, wenn sie eine WM_KEYDOWN Nachricht empfängt, aber nur, wenn das Listenfeld beide der folgenden Elemente erfüllt:

Weist den LBS_WANTKEYBOARDINPUT Formatvorlagensatz auf.
Verfügt über mindestens ein Element.

Sie sollten diese Funktion niemals selbst aufrufen. Überschreiben Sie diese Funktion, um ihre eigene benutzerdefinierte Behandlung von Tastaturnachrichten bereitzustellen.

Sie müssen einen Wert zurückgeben, um dem Framework mitzuteilen, welche Aktion ihre Außerkraftsetzung ausgeführt hat. Ein Rückgabewert von - 2 gibt an, dass die Anwendung alle Aspekte der Auswahl des Elements behandelt hat und keine weitere Aktion durch das Listenfeld erfordert. Bevor Sie - 2 zurückgeben, können Sie die Markierung festlegen oder das Caret oder beides verschieben. Um die Auswahl festzulegen, verwenden SetCurSel oder SetSel. Um das Caret zu verschieben, verwenden Sie SetCaretIndex.

Ein Rückgabewert von - 1 gibt an, dass das Listenfeld als Reaktion auf den Tastenanschlag die Standardaktion ausführen soll. Die Standardimplementierung gibt - 1 zurück.

Beispiel

// CMyODListBox is my owner-drawn list box derived from CListBox. This
// example moves the caret down one item on the down key and up one item
// on the up key. The list box control was created with the following
// code:
//   m_myODListBox.Create(
//      WS_CHILD|WS_VISIBLE|WS_BORDER|WS_HSCROLL|WS_VSCROLL|
//      LBS_SORT|LBS_MULTIPLESEL|LBS_OWNERDRAWVARIABLE|LBS_WANTKEYBOARDINPUT,
//      CRect(10,250,200,450), pParentWnd, IDC_MYODLISTBOX);
//
int CMyODListBox::VKeyToItem(UINT nKey, UINT nIndex)
{
   // On key up, move the caret up one item.
   if ((nKey == VK_UP) && (nIndex > 0))
   {
      SetCaretIndex(nIndex - 1);
   }
   // On key down, move the caret down one item.
   else if ((nKey == VK_DOWN) && (nIndex < (UINT)GetCount()))
   {
      SetCaretIndex(nIndex + 1);
   }

   // Do not perform any default processing.
   return -2;
}

Siehe auch

MFC-Beispiel STRGTEST
CWnd Klasse
Hierarchiediagramm
CWnd Klasse
CButton Klasse
CComboBox Klasse
CEdit Klasse
CScrollBar Klasse
CStatic Klasse

Freigeben über

CListBox-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Hinweise

Vererbungshierarchie

Anforderungen

CListBox::AddString

Parameter

Rückgabewert

Hinweise

Beispiel

CListBox::CharToItem

Parameter

Rückgabewert

Hinweise

Beispiel

CListBox::CListBox

Hinweise

Beispiel

CListBox::CompareItem

Parameter

Rückgabewert

Hinweise

Beispiel

CListBox::Create

Parameter

Rückgabewert

Hinweise

Beispiel

CListBox::DeleteItem

Parameter

Hinweise

Beispiel

CListBox::DeleteString

Parameter

Rückgabewert

Hinweise

Beispiel

CListBox::Dir

Parameter

Rückgabewert

Beispiel

CListBox::DrawItem

Parameter

Hinweise

Beispiel

CListBox::FindString

Parameter

Rückgabewert

Hinweise

Beispiel

CListBox::FindStringExact

Parameter

Rückgabewert

Hinweise

Beispiel

CListBox::GetAnchorIndex

Rückgabewert

Hinweise

Beispiel

CListBox::GetCaretIndex

Rückgabewert

Hinweise

Beispiel

CListBox::GetCount

Rückgabewert

Hinweise

Beispiel

CListBox::GetCurSel

Rückgabewert

Hinweise

Beispiel

CListBox::GetHorizontalExtent

Rückgabewert

Hinweise

Beispiel

CListBox::GetItemData

`CListBox`-Klasse

`CListBox::AddString`

`CListBox::CharToItem`

`CListBox::CListBox`

`CListBox::CompareItem`

`CListBox::Create`

`CListBox::DeleteItem`

`CListBox::DeleteString`

`CListBox::Dir`

`CListBox::DrawItem`

`CListBox::FindString`

`CListBox::FindStringExact`

`CListBox::GetAnchorIndex`

`CListBox::GetCaretIndex`

`CListBox::GetCount`

`CListBox::GetCurSel`

`CListBox::GetHorizontalExtent`

`CListBox::GetItemData`

`CListBox::GetItemDataPtr`

`CListBox::GetItemHeight`

`CListBox::GetItemRect`

`CListBox::GetListBoxInfo`

`CListBox::GetLocale`

`CListBox::GetSel`

`CListBox::GetSelCount`

`CListBox::GetSelItems`

`CListBox::GetText`

`CListBox::GetTextLen`

`CListBox::GetTopIndex`

`CListBox::InitStorage`

`CListBox::InsertString`

`CListBox::ItemFromPoint`

`CListBox::MeasureItem`

`CListBox::ResetContent`