FileSelectFolder
Bietet eine graphische Ordnerauswahl an.
FileSelectFolder ( "dialog text", "root dir" [, flag = 0 [, "initial dir" [, hwnd]]] )
Parameter
| dialog text | Der Begrüßungstext. |
| root dir | Basisverzeichnis des Verzeichnisbaumes. Dieser Parameter ist zu verwenden, um die Benutzerauswahl zu beschränken. Für den Desktop ist "" zu benutzen (siehe unten)) |
| flag | [optional] $FSF_CREATEBUTTON (1) = Zeigt den Button "Neuer Ordner" (nur XP) $FSF_NEWDIALOG (2) = Verwendet neuen Dialog-Stil (nur XP) $FSF_EDITCONTROL (4) = Zeigt ein Edit-Control (nur XP) Die Konstanten sind in FileConstants.au3 definiert. |
| initial dir | [optional] Der volle Pfad des Verzeichnis, welches ausgewählt/markiert ist, wenn der Dialog angezeigt wird. Standard ist ein leerer String (""). |
| hwnd | [optional] Das Fenster Handle welches als Parent für diesen Dialog verwendet werden soll. |
Rückgabewert
| Erfolg: | Den vollständigen Pfad des ausgewählten Ordners. |
| Fehler: | Einen leeren String und setzt @error auf 1, wenn der Benutzer das Fenster geschlossen bzw. abgebrochen hat. |
Bemerkungen
Wenn ein nicht vorhandenes Root-Verzeichnis verwendet wird, wird der Desktop-Ordner verwendet.
Es ist zu beachten, dass Desktop der Basisordner für den gesamten Computer ist und nicht mit @DesktopDir identisch ist. Dies ist der aktuelle Benutzerdesktop.
Besondere Windows-Ordner (wie z.B. "Dokumente und Einstellungen") können als Basisverzeichnis gesetzt werden, indem man ihre CLSIDs angibt. Siehe Anhang CLSIDs besonderer Ordner.
UNC Pfade werden nicht unterstützt. Falls man jedoch benötigt, dass man Dateien auf UNC-Pfaden auswählen kann, dann muss der Pfad zuerst als Laufwerksbuchstabe gemappt werden.
UNC ist ein Netzwerkpfad.
Der neue vista+ Dialogstil wird, wenn möglich, unabhängig von der Verwendung des New-Diaglog-Stiles verwendet. Mit dem Vista-Dialog-Stil werden das Edit-Control und der "Neuer Ordner"-Button immer angezeigt, wobei der Flags-Parameter ignoriert wird und der Dialogtext-Parameter den Fenstertitel setzt.
Verwandte Funktionen
FileOpenDialog, FileSaveDialog
Beispiel
#include <MsgBoxConstants.au3>
Example()
Func Example()
; Erstellt eine Konstante im lokalen Bereich der Nachricht die in FileSelectFolder dargestellt werden soll.
Local Const $sMessage = "Select a folder"
; Zeigt einen Öffnen-Dialog an eine Datei auszuwählen.
Local $sFileSelectFolder = FileSelectFolder($sMessage, "")
If @error Then
; Zeigt die Fehlermeldung.
MsgBox($MB_SYSTEMMODAL, "", "Kein Ordner ausgewählt.")
Else
; Zeigt den ausgewählten Ordner
MsgBox($MB_SYSTEMMODAL, "", "Es wurde der folgende Ordner ausgewählt:" & @CRLF & $sFileSelectFolder)
EndIf
EndFunc ;==>Example