Creer fenetre formulaire

4D v15.4


Creer fenetre formulaire ( {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 Creer fenetre formulaire 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 AJOUTER ENREGISTREMENT).

Par défaut, si le paramètre type n’est pas passé, la fenêtre créée est de type standard et comporte une case de fermeture. A la différence de la commande Creer fenetre, 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 Sur case de fermeture est activé pour le formulaire, auquel cas le code associé à cet événement sera exécuté.

Si le formulaire nomForm est redimensionnable, la fenêtre créée comporte également une case de zoom et une case de contrôle de taille.

Note : Vous pouvez connaître les principales propriétés d’un formulaire à l’aide de la commande FORM LIRE PROPRIETES.

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 avec mode plein écran Mac	Entier long	65536
Form dialogue modal	Entier long	1
Form dialogue modal déplaçable	Entier long	5
Form fenêtre barre outils	Entier long	35
Form fenêtre feuille	Entier long	33
Form fenêtre palette	Entier long	1984
Form fenêtre pop up	Entier long	32
Form fenêtre standard	Entier long	8

Notes :

Les 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.
La constante Form avec mode plein écran Mac doit être ajoutée à l'une des autres constantes de type.
Pour plus d'informations sur les types de fenêtres, reportez-vous à la section Types de fenêtres (compatibilité). A noter que seuls les types listés dans le thème Creer fenetre formulaire peuvent être utilisés avec la commande Creer fenetre formulaire.

Lorsque la constante Form fenêtre barre outils est passée, la fenêtre est créée avec l'emplacement, la taille et les propriétés graphiques d'une barre d'outils, c'est-à-dire :

La fenêtre sera toujours affichée juste sous la barre de menus.
La largeur de la fenêtre sera automatiquement ajustée afin de remplir tout l'espace horizontal disponible sur le bureau (sous OS X) ou dans la fenêtre principale de 4D (sous Windows). La hauteur de la fenêtre est basée sur les propriétés du formulaire, comme pour tous les autres types de fenêtres formulaires.
La fenêtre n'a pas de bordure, ne peut pas être déplacée ni redimensionnée manuellement ; les paramètres posH, posV et * sont ignorés lorsqu'ils sont passés.
Il n'est pas possible de créer simultanément plus d'une barre d'outils. Si Creer fenetre formulaire est appelée avec le type Form fenêtre barre outils alors qu'une fenêtre barre d'outils est déjà définie, l'erreur -10613 ("Impossible de créer deux fenêtres formulaires de type barre d'outils") est générée.

Barre d'outils et mode plein écran sous OS X : Si votre application affiche à la fois une fenêtre barre d'outils et une fenêtre standard qui prend en charge le mode plein écran (option Form avec mode plein écran Mac), les règles d'interface préconisent que la barre d'outils soit masquée lorsque la fenêtre standard passe en mode plein écran. Pour savoir si une fenêtre est passée en mode plein écran, il vous suffit de tester si sa hauteur est identique à celle de l'écran (cf. commande CACHER BARRE OUTILS).

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 points (cf. commande Creer fenetre), ou l’une des constantes prédéfinies suivantes, placées dans le thème "Creer fenetre formulaire" :

Constante	Type	Valeur
A droite	Entier long	196608
A gauche	Entier long	131072
Centrée horizontalement	Entier long	65536

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 points (cf. commande Creer fenetre), ou l’une des constantes prédéfinies suivantes, placées dans le thème "Creer fenetre formulaire" :

Constante	Type	Valeur
Centrée verticalement	Entier long	262144
En bas	Entier long	393216
En haut	Entier long	327680

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:=Creer fenetre formulaire([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:=Creer fenetre formulaire("Outils";Form fenêtre palette;A gauche;En haut;*)

Voir aussi

Creer fenetre
FORM LIRE PROPRIETES
Types de fenêtres (compatibilité)