Fenêtres formulaires barres d'outils

4D v15

Introduit dans 4D v14 R5

4D v15 comporte une série d'implémentations destinées à aider les développeurs à concevoir et à gérer des barres d'outils personnalisées. Les barres d'outils sont des fenêtres dotées de propriétés de position et de taille spécifiques.

Les commandes suivantes prennent en charge la création et la gestion de barres d'outils :

Open form window : accepte le nouveau type Toolbar form window.
Tool bar height : retourne la hauteur de la barre d'outils personnalisée.
HIDE TOOL BAR et SHOW TOOL BAR : précédemment obsolètes, ces commandes ont été réactivées pour la gestion des barres d'outils personnalisées.

Creer fenetre formulaire/Open form window

Thème : Fenêtres



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

La commande Open form window peut désormais créer des fenêtres formulaire de type Barre d'outils.

Une nouvelle constante a été ajoutée dans le thème "Creer fenetre formulaire", utilisable dans le paramètre type :

Constante	Type	Valeur
Form fenêtre barre outils	Entier long	35

Lorsque la constante Toolbar form window 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 Open form window est appelée avec le type Toolbar form window 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.

Fenêtre formulaire 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 has full screen mode 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 (voir ci-dessous).

Hauteur barre outils/Tool bar height

Thème : Fenêtres (commande déplacée depuis le thème "Interface utilisateur")

Tool bar height -> Résultat

Paramètre	Type		Description
Résultat	Entier long	<-	Hauteur (exprimée en pixels) de la barre d’outils ou 0 si la barre d’outils n’est pas affichée

Cette commande prend désormais en charge les barres d'outils personnalisées créées avec la commande Open form window associée au type Toolbar form window.

Cette commande retourne la hauteur de la barre d'outils visible courante, exprimée en pixels. Suivant le contexte, il peut s'agir soit de la barre d'outils du mode Développement de 4D, soit d'une barre d'outils personnalisée créée avec Open form window (la barre d'outils du mode Développement est automatiquement masquée lorsqu'une barre d'outils personnalisée est affichée).

Si aucune barre d'outils n'est affichée, la commande retourne 0.

AFFICHER BARRE OUTILS et CACHER BARRE OUTILS/SHOW TOOLBAR et HIDE TOOLBAR

Thème : Fenêtres (commandes déplacées depuis le thème "Interface utilisateur")



	SHOW TOOL BAR Ne requiert pas de paramètre HIDE TOOL BAR Ne requiert pas de paramètre

Ces commandes ne sont plus obsolètes dans 4D : elles peuvent désormais être utilisées pour gérer l'affichage des barres d'outils personnalisées créées par la commande Open form window pour le process courant.

SHOW TOOL BAR : Si une fenêtre barre d'outils a été créée par la commande Open form window avec l'option Toolbar form window, la commande rend visible la fenêtre. Si la fenêtre barre d'outils était déjà visible ou si aucune fenêtre de ce type n'a été créée, la commande ne fait rien.
HIDE TOOL BAR : Si une fenêtre barre d'outils a été créée par la commande Open form window avec l'option Toolbar form window, la commande masque la fenêtre. Si la fenêtre barre d'outils était déjà masquée ou si aucune fenêtre de ce type n'a été créée, la commande ne fait rien.

Exemple

Sous OS X, vous avez défini une barre d'outils personnalisée ainsi qu'une fenêtre standard ayant l'option Form has full screen mode Mac. Lorsque la fenêtre standard est passée en plein écran par un utilisateur alors que la barre d'outils est affichée, vous ne voulez pas que la barre d'outils empiète sur la fenêtre plein écran.

Pour cela, dans l'événement On Resize du formulaire de la fenêtre standard, il suffit de détecter le passage en mode plein écran et d'appeler HIDE TOOL BAR dans ce cas :

 Case of

    :(Form event=On Resize)

       GET WINDOW RECT($left;$top;$right;$bottom)

       If(Screen height=($bottom-$top))

          HIDE TOOL BAR

       Else

          SHOW TOOL BAR

       End if

 End case

Constantes obsolètes

Les constantes de prise en charge du bouton de la barre d'outils Mac OS sont désormais préfixées _O_, l'option correspondante ayant été déclarée obsolète par Apple depuis OS X 10.6 :

Has toolbar button Mac (thèmes "Creer fenetre" et "Creer fenetre formulaire") a été renommée _O_Has toolbar button Mac.
On Mac Toolbar Button (thème "Evénements formulaire") a été renommée _O_On Mac Toolbar Button.