Listenfeld

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Listenfeldern verwendet werden. Ein Listenfeld ist ein Steuerelementfenster, das eine einfache Liste von Elementen enthält, aus denen der Benutzer auswählen kann. Verwenden Sie für komplexere Listen stattdessen die Listenansicht.

Überblicke

Thema	Inhalt
zu Listenfeldern	Beschreibt Listenfeldfeatures.
Verwenden von Listenfeldern	Erläutert, wie Aufgaben ausgeführt werden, die Listenfeldern zugeordnet sind.

Funktionen

Thema	Inhalt
DlgDirList-	Ersetzt den Inhalt eines Listenfelds durch die Namen der Unterverzeichnisse und Dateien in einem angegebenen Verzeichnis.
DlgDirSelectEx-	Ruft die aktuelle Auswahl aus einem Listenfeld mit einer Auswahl ab.
DrawInsert-	Zeichnet das Symbol "Einfügen" im übergeordneten Fenster des angegebenen Listenfelds für ziehen.
GetListBoxInfo-	Ruft Informationen zum angegebenen Listenfeld ab.
LBItemFromPt-	Ruft den Index des Elements am angegebenen Punkt in einem Listenfeld ab.
MakeDragList-	Ändert das angegebene Listenfeld für einmalige Auswahl in ein Listenfeld mit Ziehen.

Meldungen

Thema	Inhalt
LB_ADDFILE	Fügt den angegebenen Dateinamen zu einem Listenfeld hinzu, das eine Verzeichnisauflistung enthält.
LB_ADDSTRING	Fügt einem Listenfeld eine Zeichenfolge hinzu.
LB_DELETESTRING	Löscht eine Zeichenfolge in einem Listenfeld.
LB_DIR	Fügt der Liste, die von einem Listenfeld angezeigt wird, Namen hinzu.
LB_FINDSTRING	Sucht die erste Zeichenfolge in einem Listenfeld, das mit der angegebenen Zeichenfolge beginnt.
LB_FINDSTRINGEXACT	Sucht die erste Listenfeldzeichenfolge, die exakt der angegebenen Zeichenfolge entspricht, mit der Ausnahme, dass bei der Suche die Groß-/Kleinschreibung nicht beachtet wird.
LB_GETANCHORINDEX	Ruft den Index des Ankerelements ab, das heißt, das Element, von dem eine Mehrfachauswahl beginnt.
LB_GETCARETINDEX	Ruft den Index des Elements ab, das das Fokusrechteck in einem Listenfeld mit mehrfacher Auswahl enthält. Das Element kann ausgewählt oder nicht ausgewählt werden.
LB_GETCOUNT	Ruft die Anzahl der Elemente in einem Listenfeld ab.
LB_GETCURSEL	Ruft den Index des aktuell ausgewählten Elements(sofern vorhanden) in einem Listenfeld mit einer Auswahl ab.
LB_GETHORIZONTALEXTENT	Ruft die Breite in Pixeln ab, in der ein Listenfeld horizontal gescrollt werden kann (bildlauffähige Breite), wenn das Listenfeld eine horizontale Bildlaufleiste aufweist.
LB_GETITEMDATA	Ruft den anwendungsdefinierten Wert ab, der dem angegebenen Listenfeldelement zugeordnet ist.
LB_GETITEMHEIGHT	Ruft die Höhe von Elementen in einem Listenfeld ab.
LB_GETITEMRECT	Ruft die Abmessungen des Rechtecks ab, das ein Listenfeldelement begrenzt, wie es derzeit im Listenfeld angezeigt wird.
LB_GETLISTBOXINFO	Ruft die Anzahl der Elemente pro Spalte in einem angegebenen Listenfeld ab.
LB_GETLOCALE	Ruft das aktuelle Gebietsschema des Listenfelds ab.
LB_GETSEL	Ruft den Auswahlstatus eines Elements ab.
LB_GETSELCOUNT	Ruft die Gesamtanzahl der ausgewählten Elemente in einem Listenfeld mit Mehrfachauswahl ab.
LB_GETSELITEMS	Füllt einen Puffer mit einem Array ganzzahliger Zahlen, die die Elementnummern ausgewählter Elemente in einem Listenfeld mit Mehrfachauswahl angeben.
LB_GETTEXT	Ruft eine Zeichenfolge aus einem Listenfeld ab.
LB_GETTEXTLEN	Ruft die Länge einer Zeichenfolge in einem Listenfeld ab.
LB_GETTOPINDEX	Ruft den Index des ersten sichtbaren Elements in einem Listenfeld ab.
LB_INITSTORAGE	Ordnet Speicher zum Speichern von Listenfeldelementen zu. Diese Meldung wird verwendet, bevor eine Anwendung einem Listenfeld eine große Anzahl von Elementen hinzufügt.
LB_INSERTSTRING	Fügt eine Zeichenfolge oder Elementdaten in ein Listenfeld ein. Im Gegensatz zur LB_ADDSTRING Nachricht führt die LB_INSERTSTRING Nachricht nicht dazu, dass eine Liste mit dem LBS_SORT Format sortiert wird.
LB_ITEMFROMPOINT	Ruft den nullbasierten Index des Elements ab, das dem angegebenen Punkt in einem Listenfeld am nächsten ist.
LB_RESETCONTENT	Entfernt alle Elemente aus einem Listenfeld.
LB_SELECTSTRING	Durchsucht ein Listenfeld nach einem Element, das mit den Zeichen in einer angegebenen Zeichenfolge beginnt.
LB_SELITEMRANGE	Markiert oder deaktiviert ein oder mehrere aufeinander folgende Elemente in einem Listenfeld mit mehrfacher Auswahl.
LB_SELITEMRANGEEX	Wählt ein oder mehrere aufeinander folgende Elemente in einem Listenfeld mit mehrfacher Auswahl aus.
LB_SETANCHORINDEX	Legt das Ankerelement fest, das heißt, das Element, von dem aus eine Mehrfachauswahl beginnt. Eine Mehrfachauswahl umfasst alle Elemente vom Ankerelement bis zum Caretelement.
LB_SETCARETINDEX	Legt das Fokusrechteck auf das Element am angegebenen Index in einem Listenfeld mit Mehrfachauswahl fest. Wenn das Element nicht sichtbar ist, wird es in die Ansicht gescrollt.
LB_SETCOLUMNWIDTH	Legt die Breite aller Spalten in Pixel in einem mehrspaltigen Listenfeld fest.
LB_SETCOUNT	Legt die Anzahl der Elemente in einem Listenfeld fest, das mit der LBS_NODATA Formatvorlage erstellt und nicht mit der LBS_HASSTRINGS Formatvorlage erstellt wurde.
LB_SETCURSEL	Wählt eine Zeichenfolge aus und scrollt bei Bedarf in die Ansicht.
LB_SETHORIZONTALEXTENT	Legt die Breite in Pixel fest, um die ein Listenfeld horizontal gescrollt werden kann (bildlauffähige Breite).
LB_SETITEMDATA	Legt einen Wert fest, der dem angegebenen Element in einem Listenfeld zugeordnet ist.
LB_SETITEMHEIGHT	Legt die Höhe von Elementen in Pixeln in einem Listenfeld fest.
LB_SETLOCALE	Legt das aktuelle Gebietsschema des Listenfelds fest.
LB_SETSEL	Wählt eine Zeichenfolge in einem Listenfeld mit mehrfacher Auswahl aus.
LB_SETTABSTOPS	Legt die Tabstopppositionen in einem Listenfeld fest.
LB_SETTOPINDEX	Stellt sicher, dass das angegebene Element in einem Listenfeld sichtbar ist.

Benachrichtigungen

Thema	Inhalt
LBN_DBLCLK	Benachrichtigt die Anwendung, dass der Benutzer in einem Listenfeld auf ein Element doppelklicken hat.
LBN_ERRSPACE	Benachrichtigt die Anwendung, dass das Listenfeld nicht genügend Arbeitsspeicher zuordnen kann, um eine bestimmte Anforderung zu erfüllen.
LBN_KILLFOCUS	Benachrichtigt die Anwendung, dass das Listenfeld den Tastaturfokus verloren hat.
LBN_SELCANCEL	Benachrichtigt die Anwendung, dass der Benutzer die Auswahl in einem Listenfeld abgebrochen hat.
LBN_SELCHANGE	Benachrichtigt die Anwendung, dass sich die Auswahl in einem Listenfeld geändert hat.
LBN_SETFOCUS	Benachrichtigt die Anwendung, dass das Listenfeld den Tastaturfokus erhalten hat.
WM_CHARTOITEM	Gesendet von einem Listenfeld mit der LBS_WANTKEYBOARDINPUT Formatvorlage an den Besitzer als Reaktion auf eine WM_CHAR Nachricht.
WM_CTLCOLORLISTBOX	Wird an das übergeordnete Fenster eines Listenfelds gesendet, bevor das System das Listenfeld zeichnet. Durch Reaktion auf diese Meldung kann das übergeordnete Fenster die Text- und Hintergrundfarben des Listenfelds mithilfe des angegebenen Anzeigegerätekontexthandles festlegen.
WM_DELETEITEM	Wird an den Besitzer eines Listenfelds oder Kombinationsfelds gesendet, wenn das Listenfeld oder Kombinationsfeld zerstört wird oder wenn Elemente von der LB_DELETESTRING, LB_RESETCONTENT, CB_DELETESTRINGoder CB_RESETCONTENT Nachricht entfernt werden.
WM_VKEYTOITEM	Gesendet von einem Listenfeld mit der LBS_WANTKEYBOARDINPUT Formatvorlage an den Besitzer als Reaktion auf eine WM_KEYDOWN Nachricht.
DL_BEGINDRAG	Benachrichtigt das übergeordnete Fenster des Ziehlistenfelds, dass der Benutzer auf die linke Maustaste auf ein Element geklickt hat.
DL_CANCELDRAG	Signal, dass der Benutzer einen Ziehvorgang abgebrochen hat, indem er auf die rechte Maustaste klickt oder die ESC-TASTE drückt.
DL_DRAGGING	Signalisiert, dass der Benutzer beim Ziehen eines Elements die Maus bewegt hat.
DL_DROPPED	Signal, dass der Benutzer einen Ziehvorgang abgeschlossen hat, indem er die linke Maustaste loslässt.

Strukturen

Thema	Inhalt
DELETEITEMSTRUCT-	Enthält Informationen zu einem gelöschten Listenfeld- oder Kombinationsfeldelement.
DRAGLISTINFO-	Enthält Informationen zu einem Drag-Ereignis. Der Zeiger auf DRAGLISTINFO- wird als lParam Parameter der Ziehlistennachricht übergeben.

Konstanten

Thema	Inhalt
Listenfeldformatvorlagen	Beschreibt die Fensterformatvorlagen, die ein Listenfeld-Steuerelement definieren.