Aller au contenu principal
Version: Next

SET HELP MENU

SET HELP MENU ( menuCol )

ParamètreTypeDescription
menuColCollectionCollection of menu objects

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description

La commande SET HELP MENU vous permet de remplacer le menu Aide par défaut de 4D par la collection d'éléments de menu MenuCol dans le mode d'application.

Cette commande remplace le menu Aide par défaut du mode d'application dans tous les environnements 4D : interprété, compilé, fusionné, mono et client/serveur.

Notes :

  • Le label "Help" lui-même est géré par le système et ne peut pas être personnalisé avec cette commande.
  • Les menus d'aide personnalisés ne prennent pas en charge les sous-menus, les coches, les styles ou les icônes.

Dans menuCol, passez une collection d'objets de menu définissant tous les éléments du menu d'aide personnalisé. Chaque objet de menu peut inclure les propriétés suivantes :

PropriétéTypeDescription
titleTexteNom de l'élément de menu
methodTexte | 4D.FunctionNom de la méthode du projet ou de l'objet de formule 4D à exécuter lorsque l'élément de menu est sélectionné. Lorsque cette propriété est utilisée, la propriété "action" ne doit pas être transmise (sinon la "method" est ignorée).
workerTexte | NombreNom du worker ou Numéro du processus qui doit gérer l'exécution du code de la "method". Plusieurs configurations sont possibles, en fonction de la valeur de la propriété "worker" :
s'il s'agit d'un nom du worker (Texte), 4D utilise ou crée ce worker pour exécuter la "method" (équivalent à CALL WORKER) si c'est un numéro de processus, 4D utilise ce processus s'il existe, sinon rien ne se passe (équivalent à CALL WORKER) s'il est indéfini et que l'application affiche un dialogue courant (dialogue le plus en avant), 4D utilise le processus de ce dialogue (équivalent à CALL FORM) s'il est indéfini et que l'application n'affiche pas de dialogue en cours, 4D appelle et utilise le worker 1 (4D distant/mono) ou le worker 4D_server_interface (4D Server).
actionTexteAction standard à exécuter lorsque l'élément de menu est sélectionné. Lorsque cette propriété est utilisée, la propriété "method" est ignorée si elle est transmise.
shortcutKeyTexteTouche de raccourci de l'élément (à appeler avec la touche Ctrl/Commande)
shortcutShiftBooléenVrai pour ajouter la touche Shift au raccourci de l'élément
shortcutAltBooléenVrai pour ajouter la touche Alt/Option au raccourci de l'élément

Le menu Aide personnalisé affichera les éléments dans le même ordre que la collection.

Pour insérer une ligne de séparation, passez null ou un objet vide dans la collection.

Exemple

Vous souhaitez personnaliser le menu Aide de votre application :

 var $col : Collection
 $col:=Créer collection
 $col.push(Créer objet("title";"Knowledge base";"worker";"workerHlp";"method";"methodHlp";"shortcutAlt";True;"shortcutKey";"Y"))
 $col.push(Null) //pour ajouter une ligne de séparation
 $col.push(Créer objet("title";"Tools";"action";ak msc;"shortcutShift";True;"shortcutKey";"Y"))
 SET HELP MENU($col)
 APPELER SURÀPROPOS("À propos de cette application";"m_apropos") //pour remplacer "A propos de 4D" sur Windows

Voir aussi

SET ABOUT