Open form window

4D v16.3

Open form window


Open form window ( {laTable ;} nomForm {; type {; posH {; posV {; *}}}} ) -> Résultat

Paramètre	Type	Description
laTable	Table	Table du formulaire ou Table par défaut si ce paramètre est omis
nomForm	Chaîne	Nom du formulaire
type	Entier long	Type de la fenêtre
posH	Entier long	Position horizontale de la fenêtre
posV	Entier long	Position verticale de la fenêtre
*	Opérateur	Conserver la position et la taille précédentes de la fenêtre
Résultat	RefFen	Numéro de référence de la fenêtre

Description

La commande Open form window crée une nouvelle fenêtre utilisant les propriétés de taille et de redimensionnement du formulaire nomForm, passé en paramètre.

A noter que le formulaire nomForm n’est pas affiché dans la fenêtre créée. Il vous appartient, si vous le souhaitez, d’afficher le formulaire (par exemple à l’aide de la commande ADD RECORD).

Le paramètre optionnel type vous permet de spécifier un type de fenêtre. Ce paramètre doit contenir une des constantes prédéfinies suivantes, placées dans le thème "Creer fenetre formulaire" :

Constante	Type	Valeur
Form has full screen mode Mac	Entier long	65536
Modal form dialog box	Entier long	1
Movable form dialog box	Entier long	5
Palette form window	Entier long	1984
Plain form window	Entier long	8
Pop up form window	Entier long	32
Sheet form window	Entier long	33
Toolbar form window	Entier long	35

Notes :

La constante Form has full screen mode Mac doit être ajoutée à l'une des autres constantes de type.
Pour plus d'informations sur les types de fenêtres utilisables avec Open form window, reportez-vous à la section Types de fenêtres.

Par défaut, si le paramètre type n’est pas passé, la fenêtre créée est de type Plain form window.

Case de fermeture
Les fenêtres de type Movable form dialog box, Plain form window et Palette form window comportent une case de fermeture. Aucune méthode n’est associée à cette case de fermeture : un clic sur la case de fermeture provoquera simplement l’annulation du formulaire, sauf si l’événement On Close Box est activé pour le formulaire, auquel cas le code associé à cet événement sera exécuté.

Contrôle de taille
Si les propriétés "Taille de la fenêtre" du formulaire nomForm ne sont pas fixes, la fenêtre créée peut être redimensionnée par l'utilisateur. Une case de zoom peut également être disponible, suivant le type de la fenêtre. Si la propriété Largeur fixe et/ou Hauteur fixe est cochée dans les propriétés du formulaire, la taille de la fenêtre ne pourra pas être modifiée.

Note : Certains attributs de la fenêtre créée (case de contrôle de taille, case de fermeture...) dépendent des spécifications d'interface du système d'exploitation pour le type choisi. Il est donc possible d'obtenir des résultats différents en fonction de la plate-forme.

Le paramètre optionnel posH vous permet de définir l’emplacement horizontal de la fenêtre. Vous pouvez passer dans ce paramètre une coordonnée fixe exprimée en pixels (distance entre le côté gauche de la fenêtre de l'application et le côté intérieur gauche de la fenêtre), ou l’une des constantes prédéfinies suivantes, placées dans le thème "Creer fenetre formulaire" :

Constante	Type	Valeur
Horizontally centered	Entier long	65536
On the left	Entier long	131072
On the right	Entier long	196608

Le paramètre optionnel posV vous permet de définir l’emplacement vertical de la fenêtre. Vous pouvez passer dans ce paramètre une coordonnée fixe exprimée en pixels (distance entre le haut de la fenêtre de l'application et le bord supérieur de l'intérieur de la fenêtre), ou l’une des constantes prédéfinies suivantes, placées dans le thème "Creer fenetre formulaire" :

Constante	Type	Valeur
At the bottom	Entier long	393216
At the top	Entier long	327680
Vertically centered	Entier long	262144

Ces paramètres tiennent compte de la présence de la barre d’outils, de la barre de menus, et de la taille courante de la fenêtre de l’application (sous Windows).

Si vous passez le paramètre optionnel *, la position et la taille courantes de la fenêtre sont mémorisées au moment où elle est refermée. Lorsque la fenêtre est réouverte par la suite, elle conserve sa position et sa taille précédentes. Dans ce cas, les paramètres posV et posH ne sont utilisés que pour la première ouverture de la fenêtre.

Note : Pour rouvrir une fenêtre avec ses coordonnées par défaut lorsque le paramètre * est passé, maintenez la touche Maj enfoncée lors de son ouverture.

Exemple 1

L’instruction suivante ouvre une fenêtre standard avec case de fermeture automatiquement ajustée à la taille du formulaire “Entrée”. La taille de fenêtre du formulaire n'est pas fixe, la fenêtre comporte donc également une case de contrôle de taille et une case de zoom :

$refFen:=Open form window([Table1];"Entrée")

Exemple 2

L’instruction suivante ouvre, en haut et à gauche de l’écran, une palette flottante basée sur un formulaire projet nommé "Outils". Cette palette conservera sa précédente position à chaque nouvelle ouverture :

$refFen:=Open form window("Outils";Palette form window;On the left;At the top;*)

Exemple 3

Ce code doit être appelé alors qu'une fenêtre document est affichée, par exemple depuis un bouton de formulaire sous macOS :

 $maFenêtre:=Open form window("sheet form";Sheet form window)

  // A cet instant la fenêtre est créée mais reste invisible

 DIALOG([Table];"formDial")

  //l'événement Sur chargement est généré puis la fenêtre feuille est affichée, elle "descend"

  //du dessous de la barre de titre

Voir aussi

FORM GET PROPERTIES
Open window
Types de fenêtres