Version 11 (Geändert)
Open form window ({Tabelle; }FormularName{; Typ{; hPos{; vPos{; *}}}}) WinRef
Parameter | Typ | Beschreibung | |
Tabelle | Tabelle | Tabelle des Formulars, ohne Angabe | |
Standardtabelle | |||
FormularName | String | Name des Formulars | |
Typ | Lange Ganzzahl | Fenstertyp | |
hPos | Lange Ganzzahl | Horizontale Position des Fensters | |
vPos | Lange Ganzzahl | Vertikale Position des Fensters | |
* | * | Sichere aktuelle Fensterposition | |
und -größe | |||
Funktionsergebnis | WinRef | Referenznummer des Fensters |
Beschreibung
Die Funktion Open form window öffnet ein neues Fenster mit der Größe und den Eigenschaften des Formulars FormularName.
Beachten Sie, dass FormularName nicht im Fenster angezeigt wird. Wollen Sie es anzeigen, müssen Sie einen Befehl aufrufen, der ein Formular lädt, z.B. ADD RECORD.
Standardmäßig, d.h. der Parameter Typ ist nicht übergeben, wird ein Standardfenster mit einem Schließkästchen geöffnet. Im Gegensatz zur Funktion Open window wird dem Schließkästchen keine Methode zugeordnet. Klicken Sie in dieses Kästchen, wird das Fenster annulliert und geschlossen, außer wenn das Formularereignis On Close Box für das Formular aktiviert wurde. Dann wird der diesem Formularereignis zugeordnete Code ausgeführt.
Ist FormularName in der Größe anpassbar, enthält das geöffnete Fenster ein Kästchen zum Zoomen und zum Vergrößern.
Hinweis: Über den Befehl GET FORM PROPERTIES können Sie die Haupteigenschaften eines Formulars abfragen.
Mit dem optionalen Parameter Typ legen Sie einen Typ für das Fenster fest. Sie müssen eine der vordefinierten Konstanten übergeben. Diese finden Sie unter dem Thema "Open form window":
Konstante | Typ | Wert |
Plain window | Lange Ganzzahl | 8 |
Modal dialog box | Lange Ganzzahl | 1 |
Movable dialog box | Lange Ganzzahl | 5 |
Palette window | Lange Ganzzahl | 1984 |
Pop up form window | Lange Ganzzahl | 32 |
Sheet form window | Lange Ganzzahl | 33 |
Hinweise:
Die Attribute des Fensters, wie Schließkästchen, Vergrößerung, etc. richten sich nach den Oberflächenangaben des Betriebssystems für den in Typ angegebenen Fenstertyp. Das Ergebnis kann also je nach Plattform unterschiedlich sein.
Weitere Informationen zu den Fenstertypen finden Sie im Abschnitt Fenstertypen. Mit der Funktion Open form window können Sie nur die unter dem Thema "Open form window" gelisteten Typen verwenden.
Mit dem optionalen Parameter hPos definieren Sie die horizontale Position des Fensters. Sie können eine Position in Points übergeben (Siehe Funktion Open window) oder eine der vordefinierten Konstanten. Diese finden Sie unter dem Thema "Open form window":
Konstante | Typ | Wert |
Horizontally Centered | Lange Ganzzahl | 65536 |
On the Left | Lange Ganzzahl | 131072 |
On the Right | Lange Ganzzahl | 196608 |
Mit dem optionalen Parameter vPos definieren Sie die vertikale Position des Fensters. Sie können eine Position in Punkten übergeben (Siehe Funktion Open window) oder eine der vordefinierten Konstanten. Diese finden Sie unter dem Thema "Open form window":
Konstante | Typ | Wert |
Vertically Centered | Lange Ganzzahl | 262144 |
At the Top | Lange Ganzzahl | 327680 |
At the Bottom | Lange Ganzzahl | 393216 |
Diese Parameters berücksichtigen das Vorhandensein der Werkzeugleiste und der Menüleiste sowie unter Windows die aktuelle Größe des Anwendungsfensters.
Übergeben Sie den optionalen Parameter *, werden die aktuelle Position und Größe des Fensters beim Schließen gespeichert. Beim Wiederöffnen erscheint das Fenster dann mit diesen Festlegungen. Die Parameter vPos und hPos werden dann beim ersten Öffnen des Fensters verwendet.
Beispiele
(1) Folgender Code öffnet ein Standardfenster mit Schließkästchen und passt es automatisch an, so daß es dieselbe Größe wie das Eingabeformular hat. Da das Formular in der Größe veränderbar ist, hat das Fenster auch ein Kästchen zum Vergrößern und Zoomen:
$winRef := Open form window ([Table1];"Eingabe")
(2) Folgender Code öffnet ein Palettenfenster im oberen linken Bereich des Bildschirms, basierend auf dem Projektformular mit Namen "Tools". Beim Wiederöffnen verwendet dieses Fenster immer die zuletzt angegebene Position:
$winRef := Open form window ( "Tools"; Palette window; On the Left; At the Top;*)
Referenz
Fenstertypen, GET FORM PROPERTIES, Open window.