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.

Übersichten

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

Funktionen

Thema Inhalte
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 nur einer Auswahl ab.
DrawInsert Zeichnet das Einfügesymbol im übergeordneten Fenster des angegebenen Ziehlistenfelds.
GetListBoxInfo Ruft Informationen zum angegebenen Listenfeld ab.
LBItemFromPt Ruft den Index des Elements am angegebenen Punkt in einem Listenfeld ab.
MakeDragList Ändert das angegebene Einzelauswahllistenfeld in ein Ziehlistenfeld.

Nachrichten

Thema Inhalte
LB _ ADDFILE Fügt einem Listenfeld, das eine Verzeichnisauflistung enthält, den angegebenen Dateinamen hinzu.
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 genau mit der angegebenen Zeichenfolge übereinstimmt, außer dass bei der Suche die Groß-/Kleinschreibung nicht beachtet wird.
LB _ GETANCHORINDEX Ruft den Index des Ankerelements ab, d. h. das Element, ab 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 nur einer Auswahl ab.
LB _ GETHORIZONTALEXTENT Ruft die Breite in Pixel ab, die ein Listenfeld horizontal scrollen kann (die scrollbare Breite), wenn das Listenfeld über eine horizontale Scrollleiste verfügt.
LB _ GETITEMDATA Ruft den anwendungsdefinierte Wert ab, der dem angegebenen Listenfeldelement zugeordnet ist.
LB _ GETITEMHEIGHT Ruft die Höhe der Elemente in einem Listenfeld ab.
LB _ GETITEMRECT Ruft die Abmessungen des Rechtecks ab, das ein Listenfeldelement so umgrenzt, 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 Auswahlzustand eines Elements ab.
LB _ GETSELCOUNT Ruft die Gesamtzahl der ausgewählten Elemente in einem Listenfeld mit mehrfacher Auswahl ab.
LB _ GETSELITEMS Füllt einen Puffer mit einem Array von ganzen Zahlen, die die Elementnummern ausgewählter Elemente in einem Listenfeld mit mehrfacher Auswahl 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 Belegt Arbeitsspeicher zum Speichern von Listenfeldelementen. 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-Stil 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 Wählt ein oder mehrere aufeinander folgende Elemente in einem Listenfeld mit mehrfacher Auswahl aus oder deaktiviert sie.
LB _ SELITEMRANGEEX Wählt mindestens ein aufeinander folgendes Element in einem Listenfeld mit mehrfacher Auswahl aus.
LB _ SETANCHORINDEX Legt das Ankerelement fest, d. h. das Element, ab dem 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 mehrfacher Auswahl fest. Wenn das Element nicht sichtbar ist, wird es in die Ansicht gescrollt.
LB _ SETCOLUMNWIDTH Legt die Breite aller Spalten in einem Listenfeld mit mehreren Spalten in Pixel fest.
LB _ SETCOUNT Legt die Anzahl der Elemente in einem Listenfeld fest, das mit dem _ LBS-NODATA-Stil und nicht mit dem LBS _ HASSTRINGS-Stil erstellt wurde.
LB _ SETCURSEL Wählt eine Zeichenfolge aus und scrollt sie bei Bedarf in die Ansicht.
LB _ SETHORIZONTALEXTENT Legt die Breite in Pixel fest, mit der ein Listenfeld horizontal gescrollt werden kann (die 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 einem Listenfeld in Pixel 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 Inhalte
LBN _ DBLCLK Benachrichtigt die Anwendung, dass der Benutzer in einem Listenfeld auf ein Element doppelklickt.
LBN _ ERRSPACE Benachrichtigt die Anwendung, dass das Listenfeld nicht genügend Arbeitsspeicher zuweisen 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-DIAGRAMMOITEM Wird von einem Listenfeld mit dem LBS _ WANTKEYBOARDINPUT-Stil als Reaktion auf eine WM _ CHAR-Nachricht an den Besitzer gesendet.
WM _ CTLCOLORLISTBOX Wird an das übergeordnete Fenster eines Listenfelds gesendet, bevor das System das Listenfeld zeichnet. Durch Reagieren auf diese Meldung kann das übergeordnete Fenster den Text und die Hintergrundfarben des Listenfelds mithilfe des angegebenen Anzeigegerätekontexthandle 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 _ DELETESTRING-oder CB _ RESETCONTENT-Nachricht entfernt werden.
WM _ VKEYTOITEM Wird von einem Listenfeld mit dem _ LBS-Format WANTKEYBOARDINPUT als Antwort auf eine WM _ KEYDOWN-Nachricht an den Besitzer gesendet.
DL _ BEGINDRAG Benachrichtigt das übergeordnete Fenster des Ziehlistenfelds, dass der Benutzer auf die linke Maustaste auf ein Element geklickt hat.
DL _ CANCELDRAG Signalisiert, dass der Benutzer einen Ziehvorgang abgebrochen hat, indem er mit der rechten Maustaste klickt oder die ESC-Taste drückt.
_DL-DRAGING Signalisiert, dass der Benutzer beim Ziehen eines Elements die Maus bewegt hat.
DL _ DROPPED Signalisiert, dass der Benutzer einen Ziehvorgang abgeschlossen hat, indem die linke Maustaste losgelassen wird.

Strukturen

Thema Inhalte
DELETEITEMSTRUCT Enthält Informationen zu einem gelöschten Listenfeld oder Kombinationsfeldelement.
DRAGLISTINFO Enthält Informationen zu einem Ziehereignis. Der Zeiger auf DRAGLISTINFO wird als lParam-Parameter der Ziehlistenmeldung übergeben.

Konstanten

Thema Inhalte
Listenfeldstile Beschreibt die Fensterstile, die ein Listenfeld-Steuerelement definieren.