Zeigt ein Dialogfeld an, in dem der Benutzer einen Verzeichnisnamen eingeben kann.
Unit
FileCtrl
Kategorie
Dialogfelder und Meldungen
Delphi-Syntax:
Delphi-Quellcode:
function SelectDirectory(const Caption: string; const Root: WideString; out Directory: string): Boolean; overload;
function SelectDirectory(var Directory: string; Options: TSelectDirOpts; HelpCtx: Longint): Boolean; overload;
C++ Syntax:
Code:
extern
PACKAGE bool __fastcall SelectDirectory(const AnsiString Caption, const WideString Root, AnsiString &Directory);
extern
PACKAGE bool __fastcall SelectDirectory(AnsiString &Directory, TSelectDirOpts Options, int HelpCtx);
Beschreibung
Mit SelectDirectory können Sie vom Benutzer ein Verzeichnis abfragen.
Mit der ersten Syntax kann eine Windows-Verzeichnisauswahl angezeigt werden. Der Parameter Caption gibt den Titel des Dialogfelds an. Root legt das Anfangsverzeichnis fest. Das vom Benutzer gewählte Verzeichnis wird im Parameter Directory zurückgegeben. Bei dieser Syntax ändert SelectDirectory den Wert für das aktuelle Verzeichnis nicht.
Warnung: Für die Parameter Root und Directory dürfen nicht die gleichen Variablen verwendet werden.
Mit der zweiten Syntax wird das Dialogfeld Verzeichnis auswählen aufgerufen. Das im Parameter Directory übergebene Verzeichnis ist nach der Anzeige des Dialogfeldes als aktuelles Verzeichnis ausgewählt. Der Name des vom Benutzer gewählten Verzeichnisses wird in Directory zurückgegeben.
Im Parameter HelpCtx wird die Hilfekontext-ID angegeben.
Der Parameter Options enthält eine Menge von Werten. Wenn Options eine leere Menge ist, kann der Benutzer nur Verzeichnisse auswählen, die bereits existieren. In diesem Fall wird kein Feld zur Eingabe eines neuen Verzeichnisnamens angeboten. Ist Options nicht leer, bestimmen die angegebenen Werte, wie das Dialogfeld auf die Angabe eines nicht vorhandenen Verzeichnisnamens reagiert.
Bei beiden Syntaxformen gibt SelectDirectory den Wert true zurück, wenn der Benutzer ein Verzeichnis ausgewählt und mit OK bestätigt hat. Hat er Abbrechen gewählt oder das Dialogfeld geschlossen, ohne ein Verzeichnis auszuwählen, lautet der Rückgabewert false.