CB _ DIR-Nachricht

Fügt der im Kombinationsfeld angezeigten Liste Namen hinzu. Die Meldung fügt die Namen von Verzeichnissen und Dateien hinzu, die mit einer angegebenen Zeichenfolge und einem Satz von Dateiattributen übereinstimmen. CB _ DIR kann der Liste auch zugeordnete Laufwerkbuchstaben hinzufügen.

Parameter

wParam

Die Attribute der Dateien oder Verzeichnisse, die dem Kombinationsfeld hinzugefügt werden sollen. Bei diesem Parameter kann es sich um einen oder mehrere der folgenden Werte handelt.

Wert Bedeutung
DDL _ ARCHIVE
Schließt archivierte Dateien ein.
DDL _ DIRECTORY
Schließt Unterverzeichnisse ein, die in eckige Klammern eingeschlossen sind ( [ ] ).
_DDL-LAUFWERKE
Alle zugeordneten Laufwerke werden der Liste hinzugefügt. Laufwerke werden im Format [ - x - ] aufgeführt, wobei x der Laufwerkbuchstabe ist.
DDL _ EXCLUSIVE
Schließt nur Dateien mit den angegebenen Attributen ein. Standardmäßig werden Lese-/Schreibdateien auch dann aufgelistet, wenn DDL _ READWRITE nicht angegeben ist.
DDL _ HIDDEN
Schließt ausgeblendete Dateien ein.
DDL _ READONLY
Schließt schreibgeschützte Dateien ein.
DDL _ READWRITE
Enthält Lese-/Schreibdateien ohne zusätzliche Attribute. Dies ist die Standardoption.
DDL _ SYSTEM
Schließt Systemdateien ein.

lParam

Ein LPCTSTR-Zeiger auf eine auf NULL endende Zeichenfolge, die einen absoluten Pfad, relativen Pfad oder Dateinamen angibt. Ein absoluter Pfad kann mit einem Laufwerkbuchstaben beginnen (z. B. d: ) oder einem UNC-Namen (z. B. \ \ Computername \ Freigabename). Wenn die Zeichenfolge einen Dateinamen oder ein Verzeichnis mit den durch den wParam-Parameter angegebenen Attributen angibt, wird der Dateiname oder das Verzeichnis der Liste hinzugefügt. Wenn der Datei- oder Verzeichnisname Platzhalterzeichen enthält (? oder * ), werden alle Dateien oder Verzeichnisse, die mit dem Platzhalterausdruck übereinstimmen und über die vom wParam-Parameter angegebenen Attribute verfügen, der im Kombinationsfeld angezeigten Liste hinzugefügt.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert der nullbasierte Index des Der Liste hinzugefügten Nachnamens.

Wenn ein Fehler auftritt, lautet der Rückgabewert CB _ ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolgen vorhanden ist, lautet der Rückgabewert CB _ ERRSPACE.

Bemerkungen

Wenn wParam das DDL _ DIRECTORY-Flag 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, wenn das Stammverzeichnis über ausgeblendete oder Systemattribute verfügt und die _ DDL HIDDEN- und DDL _ SYSTEM-Flags nicht angegeben sind. Das Stammverzeichnis eines NTFS-Volumes verfügt über ausgeblendete und Systemattribute.

In der Liste werden ggf. lange Dateinamen angezeigt.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)

Weitere Informationen

Verweis

CB _ ADDSTRING

CB _ INSERTSTRING

DlgDirListComboBox