CW&nd::DlgDirListnbsp;

intDlgDirList (LPTSTRLpPathSpec,IntnIDListBox,IntnIDStaticPath,nFileTypeUINT);

Rückgabewert

Ungleich NULL, wenn die Funktion erfolgreich ist; andernfalls 0.

Parameter

lpPathSpec

Verweist auf eine auf Null endende Zeichenfolge, die den Pfad oder Dateinamen enthält. DlgDirList ändert dieser Zeichenfolge lang genug, um die Änderungen enthalten sein sollte. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

nIDListBox

Gibt den Bezeichner eines Listenfeldes. Wenn nIDListBox 0 ist, wird DlgDirList davon ausgegangen, dass kein Listenfeld vorhanden ist und nicht versucht, eine füllen.

nIDStaticPath

Gibt den Bezeichner des Steuerelements statisch-Text verwendet, um das aktuelle Laufwerk und Verzeichnis anzuzeigen. Wenn nIDStaticPath 0 ist, wird DlgDirList davon ausgegangen, dass keine solche Textsteuerelement vorhanden ist.

nFileType

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

• DDL_READWRITE&Nbsp;  Lese-/ Schreib-Daten-Dateien ohne zusätzliche Attribute.
  
  
• DDL_READO&NLYNbsp;  Schreibgeschützte Dateien.
  
  
• DDL_HIDDE&NNbsp;  Versteckte Dateien.
  
  
• DDL_SYSTEM&Nbsp;  Systemdateien.
  
  
• DDL_DIRECTORY&Nbsp;  Verzeichnisse.
  
  
• DDL_ARCHIVE&Nbsp;  Archiv.
  
  
• DDL_POSTMSGS&Nbsp;LB_DIR Flag. Wenn das LB_DIR -Flag festgelegt ist, legt Windows die Nachrichten von DlgDirList in der Anwendungswarteschlange erstellt; Andernfalls werden sie direkt mit dem Dialogfeld-Verfahren gesendet.
  
  
• DDL_DRIVES&Nbsp;  Laufwerke. Wenn das DDL_DRIVES -Flag festgelegt ist, wird automatisch das DDL_EXCLUSIVE -Flag festgelegt. Daher, um eine Verzeichnisliste erstellen, Laufwerke und Dateien enthält, müssen Sie DlgDirList zweimal: einmal mit der DDL_DRIVES -flag festgelegt und einmal mit den Flags für den Rest der Liste.
  
  
• DDL_EXCLUSIVE&Nbsp;  Exklusive Bit. Wenn das exklusive Bit festgelegt ist, werden nur Dateien des angegebenen Typs aufgelistet; Andernfalls werden normale Dateien und Dateien des angegebenen Typs aufgelistet.

Bemerkungen

Füllt ein Listenfeld mit einer Liste von Datei oder Verzeichnis. Sendet DlgDirList LB_RESETCONTENT und LB_DIR Nachrichten in das Listenfeld. Es füllt das Listenfeld festgelegten nIDListBox mit den Namen aller Dateien, die mit den von LpPathSpec angegebenen Pfad übereinstimmen.

Der LpPathSpec -Parameter hat das folgende Formular aus:

[Laufwerk:] [[\u]Verzeichnis[\iVerzeichnis]... \u] [Dateiname]

In diesem Beispiel Laufwerk ist ein Laufwerkbuchstabe, Verzeichnis ein gültiges Verzeichnis heißt, und Dateiname ist eine gültige, die mindestens einen Platzhalter enthalten muss. Die Platzhalter sind ein Fragezeichen (?), d. h., jedes Zeichen und ein Sternchen (), d. h. eine beliebige Anzahl von Zeichen überein überein.

Wenn Sie eine Zeichenfolge der Länge 0 für LpPathSpecangeben, oder wenn Sie nur einen Verzeichnisnamen angeben, aber keine Dateispezifikation enthalten, die Zeichenfolge werden, um geändert wird "*. *".

Wenn LpPathSpec einen Laufwerk oder Verzeichnis Namen enthält, werden das aktuelle Laufwerk und Verzeichnis zu dem bezeichneten Laufwerk und Verzeichnis vor geändert im Listenfeld gefüllt ist. Das Textsteuerelement identifiziert durch nIDStaticPath ist auch mit dem neuen Laufwerk bzw. Verzeichnisnamen aktualisiert.

Nachdem das Listenfeld gefüllt ist, wird LpPathSpec durch den Laufwerk oder Verzeichnis Teil des Pfades entfernen aktualisiert.

CWnd Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CWnd::DlgDirListComboBox, :: DlgDirList