CB_DIR Nachricht

Fügt der Liste, die im Kombinationsfeld angezeigt wird, Namen hinzu. In der Meldung werden die Namen von Verzeichnissen und Dateien hinzugefügt, die mit einer angegebenen Zeichenfolge und einem Satz von Dateiattributen übereinstimmen. CB_DIR können der Liste auch zugeordnete Laufwerkbuchstaben hinzufügen.

Parameter

wParam

Die Attribute der Dateien oder Verzeichnisse, die dem Kombinationsfeld 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, die in eckige Klammern ([ ]) eingeschlossen sind.
DDL_DRIVES	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 aufgeführt, 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 LPCTSTR-Zeiger auf eine null-endende 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 über die vom wParam-Parameter angegebenen Attribute verfügt, wird der Dateiname oder das Verzeichnis der Liste hinzugefügt. Wenn der Datei- oder Verzeichnisname Wildcardzeichen (? oder *) enthält, werden alle Dateien oder Verzeichnisse, die dem Feldplatzhalterausdruck entsprechen und die vom wParam-Parameter angegebenen Attribute aufweisen, der liste hinzugefügt, die im Kombinationsfeld angezeigt wird.

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 CB_ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolgen vorhanden ist, wird der Rückgabewert CB_ERRSPACE.

Bemerkungen

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 über ausgeblendete oder Systemattribute verfügt und die flags DDL_HIDDEN und DDL_SYSTEM nicht angegeben sind. Das Stammverzeichnis eines NTFS-Volumes verfügt über ausgeblendete Und Systemattribute.

In der Liste werden ggf. lange Dateinamen angezeigt.

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 (windows.h einschließen)

Siehe auch

Referenz

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox