ListBox_Dir Makro (windowsx.h)

Artikel
10/24/2024

Fügt der Liste, die von einem Listenfeld angezeigt wird, Namen hinzu. Das Makro fügt die Namen von Verzeichnissen und Dateien hinzu, die einer angegebenen Zeichenfolge und einem Satz von Dateiattributen entsprechen. Sie kann dem Listenfeld auch zugeordnete Laufwerkbuchstaben hinzufügen. Sie können dieses Makro verwenden oder die LB_DIR Nachricht explizit senden.

Syntax

int ListBox_Dir(
   HWND    hwndCtl,
   UINT    attrs,
   LPCTSTR lpszFileSpec
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Steuerelement.

attrs

Typ: UINT-

Die Attribute der Dateien oder Verzeichnisse, die dem Listenfeld hinzugefügt werden sollen. Weitere Informationen finden Sie unter LB_DIR.

lpszFileSpec

Typ: LPCTSTR-

Ein Zeiger auf die mit Null beendete Zeichenfolge, die einen absoluten Pfad, relativen Pfad oder Dateinamen angibt. Ein absoluter Pfad kann mit einem Laufwerkbuchstaben (z. B. d:) oder einem UNC-Namen (z. B. \computername\ sharename) beginnen.

Rückgabewert

Typ: int

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert der nullbasierte Index des Nachnamens, der der Liste hinzugefügt wurde. Wenn ein Fehler auftritt, wird der Rückgabewert LB_ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolgen vorhanden ist, wird der Rückgabewert LB_ERRSPACE.

Bemerkungen

Weitere Informationen finden Sie unter LB_DIR.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	windowsx.h

Freigeben über