Freigeben über


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.