LB_DIR Nachricht

Fügt der Liste, die von einem Listenfeld angezeigt wird, Namen hinzu. Die Nachricht fügt die Namen von Verzeichnissen und Dateien hinzu, die mit einer angegebenen Zeichenfolge und einem Satz von Dateiattributen übereinstimmen. LB_DIR können dem Listenfeld auch zugeordnete Laufwerkbuchstaben hinzufügen.

Parameter

wParam

Die Attribute der Dateien oder Verzeichnisse, die dem Listenfeld hinzugefügt werden sollen. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
DDL_ARCHIVE	Enthält archivierte Dateien.
DDL_DIRECTORY	Enthält Unterverzeichnisse. Unterverzeichnisnamen sind in eckige Klammern ([ ]) eingeschlossen.
DDL_DRIVES	Alle zugeordneten Laufwerke werden der Liste hinzugefügt. Laufwerke werden in der Form [-x-] aufgeführt, wobei x der Laufwerkbuchstabe ist.
DDL_EXCLUSIVE	Enthält nur Dateien mit den angegebenen Attributen. Standardmäßig werden Lese-/Schreibdateien aufgeführt, auch wenn DDL_READWRITE nicht angegeben ist.
DDL_HIDDEN	Enthält ausgeblendete Dateien.
DDL_READONLY	Enthält schreibgeschützte Dateien.
DDL_READWRITE	Enthält Lese-/Schreibdateien ohne zusätzliche Attribute. Dies ist die Standardeinstellung.
DDL_SYSTEM	Enthält Systemdateien.

lParam

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

Wenn die Zeichenfolge einen Dateinamen oder ein Verzeichnis angibt, das die vom wParam-Parameter angegebenen Attribute enthält, wird der Dateiname oder das Verzeichnis der Liste hinzugefügt. Wenn der Datei- oder Verzeichnisname Platzhalterzeichen (? oder *) enthält, werden alle Dateien oder Verzeichnisse, die mit dem Platzhalterausdruck übereinstimmen und die vom wParam-Parameter angegebenen Attribute aufweisen, der Liste hinzugefügt.

Rückgabewert

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

Die LB_INITSTORAGE Nachricht trägt dazu bei, die Initialisierung von Listenfeldern zu beschleunigen, die eine große Anzahl von Elementen (mehr als 100) aufweisen. Es reserviert die angegebene Menge an Arbeitsspeicher, sodass nachfolgende LB_DIR Nachrichten so schnell wie möglich dauern. Sie können Schätzungen für die Parameter wParam und lParam verwenden. Wenn Sie überschätzen, wird der zusätzliche Arbeitsspeicher zugewiesen. wenn Sie unterschätzen, wird die normale Zuordnung für Elemente verwendet, die den angeforderten Betrag überschreiten.

Wenn wParam das flag DDL_DIRECTORY enthält und lParam alle Unterverzeichnisse eines Verzeichnisses der ersten Ebene angibt, z. B. C:\TEMP\*, enthält das Listenfeld immer den Eintrag ".." für das Stammverzeichnis. Dies gilt auch dann, wenn das Stammverzeichnis ausgeblendete oder Systemattribute aufweist und die flags DDL_HIDDEN und DDL_SYSTEM nicht angegeben werden. Das Stammverzeichnis eines NTFS-Volumes weist ausgeblendete Und Systemattribute auf.

Die Liste zeigt lange Dateinamen an, falls vorhanden.

Bei einer ANSI-Anwendung konvertiert das System den Text in einem Listenfeld mithilfe von CP_ACP in Unicode. Dies kann zu Problemen führen. Beispielsweise werden römische Zeichen mit Akzenten in einem Nicht-Unicode-Listenfeld in japanischen Windows verworren. Um dies zu beheben, kompilieren Sie entweder die Anwendung als Unicode, oder verwenden Sie ein vom Besitzer gezeichnetes Listenfeld.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (einschließlich Windows.h)

Siehe auch

DlgDirList