Form-Show| Funktionsname | dcl-Form-Show |
|---|---|
| Syntax |
(dcl-Form-Show <CONTROL>
{intPositionX [als Long]}
{intPositionY [als Long]})
|
|
Syntax
(Dateiwahldialog) |
(dcl-Form-Show <CONTROL>
{strInitialDirectory [als
String]} {strInitialFilename [als String]}
{strDefaultExtension [als String]})
|
| Rückgabewert | Long, String oder Liste von Strings |
| Anwendbar auf | Andockbares Fenster , Dateiwahldialog, Modaler Dialog, Nichtmodaler Dialog, Palette |
Diese Methode instanziert einen neuen OpenDCL-Dialog. Die optionalen Argumente intPositionX und intPositionY bewirken, dass der Dialog an einer ganz bestimmten Stelle auf dem Bildschirm eingeblendet wird. Der Dateiwahldialog verwendet eine andere Syntax mit den optionalen Argumenten für das Anfangsverzeichnis, einem Vorschlag für einen Dateinamen und der voreingestellten Dateierweiterung. Bitte beachten Sie bei modalen und nichtmodalen Dialogen auch den Abschnitt Modal vs. nichtmodal.
Ist der angegebene Dialog ein modaler Dialog, wird diese Methode solange nicht abgeschlossen, bis der Dialog geschlossen wird. Dabei wird ein Wert zurückgegeben, der den Dialogstatus anzeigt. Wurde der Dialog abgebrochen, z.B. durch Drücken der ESC-Taste, ist der Rückgabewert 2. Wurde der Dialog durch Drücken der Eingabetaste beendet, gibt die Funktion den Wert 1 zurück. Wird der Dialog durch die Methode Form-Close geschlossen, können der Methode Form_Close Werte übergeben werden, die als Rückgabewerte der Methode Form_Show übergeben werden können und nutzerspezifische Dialogstati anzeigen.
Ist der angegebene Dialog ein nichtmodaler Dialog, wird diese Methode sofort beendet und ein Bezeichner zurückgegeben, der mit jedem Mal hochgezählt wird, wenn ein neuer Dialog aufgerufen wird.
Ist der angegebene Dialog ein Dateiwahldialog, wird diese Methode solange nicht abgeschlossen, bis der Dialog geschlossen wird. Lässt der Dateiwahldialog die Auswahl mehrerer Dateien zu, wird eine Liste der markierten Dateinamen zurückgegeben, andernfalls wird ein einzelner Dateiname als String zurückgegeben.