SelectFolder

Funktionsname dcl-SelectFolder
Syntax   (dcl-SelectFolder strTitle [als String] {strDefaultDirectory [als String]} {strRootFolder [als String]} {intFlags [als BitFlag]})
Rückgabewert String

Diese Funktion fordert den Anwender auf, ein Verzeichnis zu wählen und gibt anschließend das gewählte Verzeichnis zurück oder NIL, wenn der Dialog abgebrochen wird. Wird kein Wert für intFlags angegeben wird vorgabemäßig 1 verwendet.

Bitwert Bit Bedeutung
1 0 Lässt nur Dateisystemverzeichnisse zu. Wählt der Anwender ein Verzeichnis, dass nicht zum Dateisystem gehört, wird die Schaltfläche OK deaktiviert.
2 1 Fügt keine Netzlaufwerke unter der obersten Ebene der Baumstruktur ein.
4 2 Fügt einen Statusbereich in der Dialogbox ein. Die Callback-Funktion kann nun Meldungstext an die Dialogbox setzen und so einen Statustext setzen. Das wird nicht unterstützt, wenn das Bit 6 gesetzt ist.
8 3 Gibt nur verwandte Ordner aus. Ein verwandter Ordner ist ein Ordner unterhalb des Stammordners des Namensraums. Wählt der Anwender einen verwandten Ordner, der nicht Bestandteil des Dateisystems ist, wird die Schaltfläche OK deaktiviert. Nicht ausgewählt werden können beispielsweise "Netzwerkumgebung", "Meine Webseiten" usw.).
16 4 Fügt ein Textfeld in den Auswahldialog ein, damit der Anwender den Namen eines Eintrags wählen kann.
32 5 Nicht verwendet.
64 6 Verwendet eine neue Schnittstelle, mit der es möglich ist, den Dialog zu vergrößern, Ordner per Drag&Drop zu verschieben, kopieren, oder neu zu sortieren. Außerdem können neue Ordner erstellt, bestehende umbenannt oder Verknüpfungen darauf erstellt werden.
128 7 Der Auswahldialog unterstützt die Anzeige von URL's, allerdings müssen die Bits 4, 6 und 13 ebenfalls gesetzt sein, andernfalls werden URL's unterdrückt. Und selbst wenn diese gesetzt sind, werden sie nur angezeigt, wenn der Ordner, in dem sich das anzuzeigende Element befindet, URL's unterstützt.
256 8 In Kombination mit dem Bit 6 wird an der Stelle des Textfelds ein Hinweis zur Anwendung ausgegeben. Das Bit 4 unterdrückt diese Ausgabe.
512 9 Fügt die Schaltfläche zum Erzeugen neuer Ordner nicht in die Dialogbox ein.
1024 10 Ist das ausgewählte Element eine Verknüpfung, dann soll statt dem Ziel der Name der Verknüpfung zurückgegeben werden.
2048 11 Gibt ausschließlich Computernamen zurück. Wird stattdessen irgendwas anderes ausgewählt, bleibt die Schaltfläche OK deaktiviert.
4096 12 Lässt ausschließlich die Auswahl von Druckern und Plottern zu. Wird stattdessen irgendwas anderes ausgewählt, bleibt die Schaltfläche OK deaktiviert.
8192 13 Die Dialogbox zeigt sowohl Ordner als auch Dateien.
16384 14 Der Auswahldialog kann freigegebene Ressourcen auf Remotsystemen anzeigen. Das ist für Applicationen sinnvoll, die Freigaben auf andere Rechner publuzieren wollen. Das Bit 6 muss auch gesetzt sein.