Open form window

Home

4D v20 R7

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, Objekt	Name (String) des Tabellen- oder Projektformulars, oder POSIX Pfad (String) zu einer .json Datei mit Beschreibung des Formulars, oder Objekt mit Beschreibung 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 zur Größensteuerung des Formulars FormularName.

Hinweis: Über den Befehl FORM GET PROPERTIES können Sie die Haupteigenschaften eines Formulars abfragen.

Im Parameter Formularname können Sie folgendes übergeben:

Name des Formulars (Projektformular oder Tabellenformular)
Pfad (in POSIX Syntax) zu einer gültigen .json Datei mit der Beschreibung des Formulars. Siehe Dateipfade für Formulare;
Objekt mit der Beschreibung des Formulars. Weitere Informationen dazu finden Sie unter Dynamische Formulare

FormularName wird nicht im Fenster angezeigt. Wollen Sie es anzeigen, müssen Sie einen Befehl aufrufen, der ein Formular lädt, z.B. ADD RECORD.

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
Controller form window	Lange Ganzzahl	133056
Form has full screen mode Mac	Lange Ganzzahl	65536
Form has no menu bar	Lange Ganzzahl	2048
Modal form dialog box	Lange Ganzzahl	1
Movable form dialog box	Lange Ganzzahl	5
Movable form dialog box no title	Lange Ganzzahl	524293
Palette form window	Lange Ganzzahl	1984
Plain form window	Lange Ganzzahl	8
Plain form window no title	Lange Ganzzahl	524296
Pop up form window	Lange Ganzzahl	32
Sheet form window	Lange Ganzzahl	33
Toolbar form window	Lange Ganzzahl	35

Weitere Informationen zu den Fenstertypen finden Sie im Abschnitt Fenstertypen.

Hinweis: Die Konstanten Form has full screen mode Mac und Form has no menu bar müssen zu einer der anderen Konstanten hinzugefügt werden.

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, Plain form window 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 On Close Box 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 in Pixel angeben 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 in Pixel angeben 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

Ausgangspunkt für die Koordinaten ist die linke obere Ecke vom Innenbereich des Anwendungsfensters (Windows MDI Modus) oder vom Hauptbildschirm (Mac OS und Windows SDI Modus). Sie berücksichtigen das Vorhandensein der Werkzeugleiste und der Menüleiste.

Ü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.

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

Beispiel 4

Dieses Beispiel verwendet den Pfad eines .json Formulars zum Anzeigen der Datensätze in einer Liste der Angestellten:

 Open form window("/RESOURCES/OutputPersonnel.json";Plain form window)

 ALL RECORDS([Personnel])

 DIALOG("/RESOURCES/OutputPersonnel.json";*)

Das ergibt folgendes Formular:

Siehe auch

Fenstertypen
Fenstertypen (Kompatibilität)
FORM GET PROPERTIES
Open window