4D v15

Fenêtres formulaires barres d'outils

Accueil

 
4D v15
Fenêtres formulaires barres d'outils

Fenêtres formulaires barres d'outils  


 

 

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 :

Thème : Fenêtres

 

Creer fenetre formulaire ( {laTable ;} nomForm {; type {; posH {; posV {; *}}}} ) -> Résultat

 

La commande Creer fenetre formulaire 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 :

ConstanteTypeValeur
Form fenêtre barre outilsEntier long35

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.

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 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 (voir ci-dessous).

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

 

Hauteur barre outils -> Résultat

ParamètreTypeDescription
RésultatEntier 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 Creer fenetre formulaire associée au type Form fenêtre barre outils

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 Creer fenetre formulaire (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.

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

 

AFFICHER BARRE OUTILS
Ne requiert pas de paramètre


CACHER BARRE OUTILS
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 Creer fenetre formulaire pour le process courant.

  • AFFICHER BARRE OUTILS : Si une fenêtre barre d'outils a été créée par la commande Creer fenetre formulaire avec l'option Form fenêtre barre outils, 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.
  • CACHER BARRE OUTILS : Si une fenêtre barre d'outils a été créée par la commande Creer fenetre formulaire avec l'option Form fenêtre barre outils, 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 avec mode plein écran 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 Sur redimensionnement du formulaire de la fenêtre standard, il suffit de détecter le passage en mode plein écran et d'appeler CACHER BARRE OUTILS dans ce cas :

 Au cas ou
    :(Evenement formulaire=Sur redimensionnement)
       COORDONNEES FENETRE($left;$top;$right;$bottom)
       Si(Hauteur ecran=($bottom-$top))
          CACHER BARRE OUTILS
       Sinon
          AFFICHER BARRE OUTILS
       Fin de si
 Fin de cas

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 :

  • Avec bouton barre outils Mac OS (thèmes "Creer fenetre" et "Creer fenetre formulaire") a été renommée _O_Avec bouton barre outils Mac OS.
  • Sur bouton barre outils Mac (thème "Evénements formulaire") a été renommée _O_Sur bouton barre outils Mac.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Langage
Nom intl. : Toolbar form windows

 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D v15 - Mise à jour (édition standard) ( 4D v15)