Open form window

Home

4D v16.3

Open form window


Open form window ( {Tabellenname ;} FormularName {; Typ {; hPos {; vPos {; *}}}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Tabellenname	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
*	Operator	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.

Im Gegensatz zur Funktion Open window wird dem Schließkästchen keine Methode zugeordnet. Klicken in dieses Kästchen annulliert und schließt das Fenster, außer das Formularereignis On Close Box wurde für das Formular aktiviert. Dann wird der dazugehörige Code ausgeführt.

Ist FormularName in der Größe anpassbar, enthält das geöffnete Fenster jeweils 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 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).

Standardmäßig, d.h. der Parameter Typ ist nicht übergeben, wird ein Fenster vom Typ Plain form window übergeben.

Schließbox
Fenster vom Typ Movable form dialog box, [#cst id="5185"/] und Palette form window haben eine Schließbox. Dieser ist keine Methode zugewiesen. Klicken in diese Schließbox annulliert und schließt das Fenster, außer das Formularereignis [#cst id="845790"/] wurde für das Formular aktiviert. In diesem Fall wird der Code für dieses Ereignis ausgeführt.

Größensteuerung
Sind die Eigenschaften für die Fenstergröße von FormularName nicht auf "fest" gesetzt, kann der Benutzer das Fenster anpassen. Je nach Fenstertyp kann auch eine Zoombox vorhanden sein. Ist in den Formulareigenschaften die Option Feste Breite bzw. Feste Höhe markiert, lässt sich die Fenstergröße nicht verändern.

Hinweis: Einige Attribute des angelegten Fensters, wie Schließbox, Vergrößerungskästchen, etc. richten sich nach den Spezifikationen des Betriebssystems für den gewählten Typ. Deshalb kann das Ergebnis je nach verwendeter Plattform unterschiedlich sein.

Mit dem optionalen Parameter hPos definieren Sie die horizontale Position des Fensters. Sie können eine eigene Position angeben (Abstand in Pixel vom linken Rand des Anwendungsfensters zum linken inneren Rand des Fensters) 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 eigene Position angeben (Abstand in Pixel vom oberen Rand des Anwendungsfensters zum oberen inneren Rand des Fensters) 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. In diesem Fall werden die Parameter vPos und hPos nur 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, öffnen Sie das Fensters mit gedrückter Shift-Taste.

Beispiel 1

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:

$winRef :=Open form window([Table1];"Eingabe")

Beispiel 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;*)

Beispiel 3

Dieser Code muss auf macOS beim Anzeigen eines Dokumentfensters aufgerufen werden, um ein Sheet Fenster zu öffnen:

 $myWin:=Open form window("sheet form";Sheet form window)

  // Momentan wird das Fenster erstellt, bleibt aber unsichtbar

 DIALOG([aTable];"dialForm")

  //Das Ereignis On Load wird generiert, dann erscheint das "Sheet" Fenster; 

  //es rollt unterhalb der Titelleise auf

Siehe auch

Fenstertypen
FORM GET PROPERTIES
Open window