GETDIR( )-Funktion
Zeigt das Dialogfeld Verzeichnis auswählen zum Auswählen eines Verzeichnisses an.
GETDIR([cDirectory [, cText [, cCaption [, nFlags [, lRootOnly]]]]])
Rückgabewerte
Zeichen
Parameter
cPath
Gibt das Verzeichnis an, das anfangs im entsprechenden Dialogfeld angezeigt wird. Wird cDirectory nicht angegeben, wird im Dialogfeld zunächst das Visual FoxPro-Standardverzeichnis angezeigt.cText
Gibt den Text für die Verzeichnis- bzw. Ordnerliste des Dialogfeldes an.cCaption
Gibt die Beschriftung an, die in der Titelleiste des Dialogs angezeigt werden soll. Die Standardeinstellung für Windows lautet Ordner suchen.nFlags
Ermöglicht die Angabe der Optionen für das Dialogfeld. nFlags kann Null oder eine kumulierende Wertekombination enthalten. Die folgende Tabelle enthält einige der häufig verwendeten Einstellungen. Weitere Informationen finden Sie unter SHBrowseForFolder in MSDN.nFlag Value Beschreibung 1 BIF_RETURNONLYFSDIRS Nur Verzeichnisse des Dateisystems werden zurückgegeben (physikalische Speicherorte). Wählt ein Benutzer Ordner aus, die nicht zum Dateisystem gehören, ist die Schaltfläche OK ausgeblendet. 2 BIF_DONTGOBELOWDOMAIN Netzwerkordner unter der Domänenebene werden nicht in die Verzeichnisansicht aufgenommen (z. B. Arbeitsplatz und Netzwerkumgebung). 8 BIF_RETURNFSANCESTORS Nur Oberklassen des Dateisystems werden zurückgeben. Wählt ein Benutzer keine Oberklasse aus, ist die Schaltfläche OK ausgeblendet. 16 BIF_EDITBOX Der Suchdialog umfasst ein Bearbeitungssteuerelement, in dem der Benutzer den Namen eines Elements eingeben kann. Ist für Windows 98 und höher oder für Internet Explorer 4.0 oder höher verfügbar (vorausgesetzt die Option für die Shellintegration ist aktiviert). Erfordert Shell32.DLL, Version 4.71. 64 BIF_NEWDIALOGSTYLE Die neue Benutzerschnittstelle wird verwendet. Wird dieses Flag gesetzt, erhält der Benutzer ein größeres, veränderbares Dialogfeld. Weitere Funktionen: Drag & Drop im Dialogfeld, Neu anordnen, Kontextmenüs, neue Ordner, Löschen und andere Kontextmenübefehle. Wird in Windows 2000 und höher unterstützt. Erfordert Shell32.DLL, Version 5.00. 16384 BIF_BROWSEINCLUDEFILES Im Suchdialog werden Dateien und Ordner angezeigt. Ist für Windows 98 und höher oder für Internet Explorer 4.0 oder höher verfügbar (vorausgesetzt die Option für die Shellintegration ist aktiviert). Erfordert Shell32.DLL, Version 4.71. lRootOnly
Gibt an, dass nur cDirectory und dessen Unterordner angezeigt werden. Mit diesem Parameter wird das Navigieren über dem Stammordner verhindert. Wenn Sie cDirectory nicht angeben, wird das Standardverzeichnis (SET DEFAULT) verwendet.
Hinweise
GETDIR( ) gibt als Zeichenfolge das Verzeichnis zurück, das Sie ausgewählt haben.
Wenn Sie kein Verzeichnis gewählt, sondern auf Abbrechen geklickt, ESC gedrückt oder aus dem Systemmenü den Befehl Schließen gewählt haben, gibt GETDIR( ) eine leere Zeichenfolge zurück.
In dieser Version von Visual FoxPro unterstützt GETDIR( ) zwei unterschiedliche Dialogfelder. Wenn Sie weniger als drei Parameter angeben, gibt GETDIR( ) das Dialogfeld von früheren Versionen zurück. Wenn Sie mehr als zwei Parameter angeben, verwendet Visual FoxPro die SHBrowseForFolder-Routine aus der Win32-API, um den Dialog zur Verfügung zu stellen.