DlgDirListComboBox

Die DlgDirListComboBox -Funktion füllt das angegebene Kombinationsfeld mit einer Verzeichnisauflistung. Es füllt die Liste mit den Namen aller Dateien, Laufwerke und Unterverzeichnisse, die den angegebenen Attributen und Path Zeichenfolge entsprechen.

Int DlgDirListComboBox) HWND  hDlg,, / / handle auf das Dialogfeld mit KombinationsfeldLPTSTRlpPathSpec, / / Zeiger auf Pfad oder Dateiname ZeichenfolgeintnIDComboBox, / / Bezeichner des KombinationsfeldsintnIDStaticPath, / / Bezeichner des statischen SteuerelementsUINTuFiletype / / Datei Attribute zum Anzeigen);
 

Parameter

hDlg

Handle für das Dialogfeld, das im Kombinationsfeld enthält.

lpPathSpec

Zeiger auf eine Null-terminierte Zeichenfolge der folgenden form:

[drive:][\]][Verzeichnis\[...]][Dateiname]

Wenn die angegebene Zeichenfolge ein Laufwerk oder Verzeichnis-Pfad, die DlgDirListComboBox -Funktion enthält wird das aktuelle Laufwerk und Verzeichnis vor dem Ausfüllen der Liste. Nachdem die Liste gefüllt ist, der Laufwerk und Verzeichnis-Pfad aus durch den LpPathSpec -Parameter angegebenen Zeichenfolge entfernt werden.

nIDComboBox

Gibt die ID des ein Kombinationsfeld-Steuerelement in einem Dialogfeld angezeigt. Wenn nIDComboBox NULL ist, übernimmt die DlgDirListComboBox -Funktion, kein Kombinationsfeld vorhanden ist und versucht nicht, ihn zu füllen.

nIDStaticPath

Gibt den Bezeichner für das Steuerelement statischer Text, in dem die DlgDirListComboBox -Funktion ist das aktuelle Verzeichnis anzuzeigen. Wenn nIDStaticPath NULL ist, wird DlgDirListComboBox davon ausgegangen, dass kein solches Steuerelement vorhanden ist.

uFiletype

Gibt die Attribute der Dateien angezeigt werden. Es kann eine beliebige Kombination der folgenden Werte sein.:

Wert	Bedeutung
DDL_ARCHIVE	Archivierte Dateien enthält.
DDL_DIRECTORY	Enthält Unterverzeichnisse. Unterverzeichnisnamen werden in eckigen Klammern ([]) eingeschlossen.
DDL_DRIVES	Laufwerke enthält. Laufwerke finden Sie in der Form [-X-], wobei x der Laufwerksbuchstabe ist.
DDL_EXCLUSIVE	Enthält nur die Dateien mit den angegebenen Attributen. Standardmäßig sind schreibgeschützte Dateien aufgeführt, auch wenn DDL_READWRITE nicht angegeben ist.
DDL_HIDDEN	Schließt ausgeblendete Dateien.
DDL_READONLY	Enthält schreibgeschützte Dateien.
DDL_READWRITE	Enthält schreibgeschützte Dateien ohne zusätzliche Attribute.
DDL_SYSTEM	System-Dateien enthält.
DDL_POSTMSGS	Sendet Nachrichten an die Nachrichtenwarteschlange der Anwendung. Standardmäßig sendet die DlgDirList -Funktion Nachrichten direkt an die Dialogfeldprozedur.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich NULL.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Wenn die durch LpPathSpec angegebene Zeichenfolge kein gültiger Pfad ist, kann beispielsweise die Funktion. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Wenn der LpszPathSpec -Parameter verweist auf eine Zeichenfolge der Länge 0 (null) oder eine Zeichenfolge, die ein Laufwerk oder Verzeichnis — aber kein Dateiname – der Dateiname *. * (Platzhalter) wird angenommen, dass.

Windows NT:

Die Verzeichnisliste zeigt lange Dateinamen, falls vorhanden.

Windows 95:

Die Verzeichnisliste zeigt kurze Dateinamen (8.3 Form). Die SHGetFileInfo oder GetFullPathName -Funktion können Sie den entsprechenden langen Dateinamen zu erhalten.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über die Combo-Boxen, Kombinationsfeld fungiert, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index