Open form window

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 dazugehörige 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 FORM GET 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 unter dem Thema Open form window übergeben:

Konstante	Typ	Wert
Form has full screen mode Mac	Lange Ganzzahl	65536
Modal form dialog box	Lange Ganzzahl	1
Movable form dialog box	Lange Ganzzahl	5
Palette form window	Lange Ganzzahl	1984
Plain form window	Lange Ganzzahl	8
Pop up form window	Lange Ganzzahl	32
Sheet form window	Lange Ganzzahl	33
Toolbar form window	Lange Ganzzahl	35

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.
• Die Konstante Form has full screen mode Mac muss zu einer der anderen Konstanten hinzugefügt werden.
• Weitere Informationen zu den Fenstertypen finden Sie im Abschnitt Fenstertypen (Kompatibilität). Mit Open form window können Sie nur die unter dem Thema Open form window gelisteten Typen verwenden.

Ist die Konstante Toolbar form window übergeben, wird das Fenster mit der Position, Größe und den grafischen Eigenschaften der Toolbar erstellt. Hier ein paar Beispiele:

• Das Fenster erscheint immer direkt unter der Menüleiste.
• Die Breite des Fensters wird automatisch an den horizontalen Bereich angepasst, der auf dem Desktop (OS X) oder im Hauptfenster von 4D (Windows) verfügbar ist. Die Höhe richtet sich wie bei allen anderen Arten von Formularfenstern nach den Formulareigenschaften.
• Das Fenster hat keinen Rand. Es lässt sich weder bewegen noch manuell größer oder kleiner ziehen. Sind die Parameter hPos, vPos und * angegeben, werden sie ignoriert.
• Es können nicht gleichzeitig zwei unterschiedliche Fenster mit Toolbar angelegt werden. Wird Open form window mit dem Typ Toolbar form window aufgerufen, wenn schon ein Fenster mit Toolbar existiert, wird der Fehler -10613 ("Cannot create two form windows of type toolbar") zurückgegeben.

Hinweis zum Formularfenster mit Toolbar und Vollbildmodus in OS X: Zeigt Ihre Anwendung ein Fenster mit Toolbar und ein Standardfenster an, das den Vollbildmodus unterstützt (Option Form has full screen mode Mac), muss die Toolbar ausgeblendet werden, wenn das Standardfenster in den Vollbildmodus geht. Ob das Fenster im Vollbildmodus ist, erkennen Sie daran, dass seine vertikale Größe genau der Höhe des Bildschirms entspricht (siehe Befehl HIDE TOOL BAR).

Mit dem optionalen Parameter hPos definieren Sie die horizontale Position des Fensters. Sie können eine Position in Punkten übergeben (Siehe Funktion Open window) oder eine der vordefinierten Konstanten unter dem Thema Open form window verwenden:

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 unter dem Thema Open form window verwenden:

Konstante	Typ	Wert
At the bottom	Lange Ganzzahl	393216
At the top	Lange Ganzzahl	327680
Vertically centered	Lange Ganzzahl	262144

Diese Parameter 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.

Hinweis: Ist der Parameter * übergeben und Sie wollen ein Fenster erneut mit den ursprünglichen Koordinaten in vPos und hPos öffnen, drücken Sie beim Öffnen des Fensters die Shift-Taste. 

Folgender Code öffnet ein Standardfenster mit Schließkästchen und passt es automatisch an, so dass es dieselbe Größe wie das Eingabeformular hat. Da die Größe des Formularfensters nicht auf "fest" gesetzt ist, hat das Fenster auch ein Kästchen zum Vergrößern und Zoomen:

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: