|
|
|
|
|
|
|
|
|
|
version 2003 (Modifiée)
Terminologie : La documentation sur les commandes de menus emploie indifféremment commande de menu et ligne de menu lorsqu'elle évoque une ligne d'un menu.
Barres de menus
Chaque barre de menus est identifiée par un numéro et par un nom. La première barre de menus (automatiquement créée par 4e Dimension) porte le numéro 1 et est nommée par défaut "Barre n°1". Pour pouvoir renommer une barre de menus, cliquez sur son nom dans l'éditeur de menus en maintenant la touche Ctrl (Windows) ou Commande (Mac OS). Le nom d'une barre de menus peut contenir jusqu'à 31 caractères et doit être unique.
La barre n°1 est aussi la barre de menus utilisée par défaut. Si vous souhaitez ouvrir une application avec une barre de menus autre que la barre n°1, vous devez appeler la commande CHANGER BARRE dans la Méthode base Sur ouverture.
Chaque commande de menu peut être associée à une méthode projet ou une action standard. Si vous n'affectez pas de méthode ni d'action standard à une commande de menu, la sélection de cette commande de menu provoque la sortie du mode Menus créés et le passage en mode Utilisation. Si l'utilisateur exploite une application en menus créés uniquement ou ne dispose pas des privilèges d'accès pour le mode Utilisation, cela provoquera la fermeture de l'application.
Les actions standard permettent d'effectuer diverses opérations courantes liées aux fonctions système (copier, quitter, etc.) ou de base de données 4D (ajouter enregistrement, tout sélectionner, etc.).
Vous pouvez associer à la fois une action standard et une méthode projet à une commande de menu. Dans ce cas, l'action standard n'est jamais exécutée ; toutefois, 4e Dimension utilise cette action pour activer/inactiver la commande de menu en fonction du contexte. Lorsqu'une commande de menu est inactivée, la méthode projet associée ne peut être exécutée.
Chaque barre de menus comporte par défaut trois menus — Fichier, Edition et Mode.
• Le menu Fichier ne contient qu'une commande de menu : Quitter. L'action standard Quitter lui est associée. Cette action affiche une boîte de dialogue de confirmation "Etes-vous certain ?" puis quitte l'application 4D en cas de validation. Dans le cas contraire, l'opération est annulée.
Note : Sous Mac OS X, la commande de menu créé associée à l'action Quitter est automatiquement placée dans le menu de l'application, lorsque la base est exécutée sur ce système.
Vous pouvez renommer le menu Fichier, lui ajouter des commandes de menu ou le garder tel quel. Il est recommandé de toujours garder la commande de menu Quitter comme dernière commande du menu Fichier.
• Le menu Edition contient les commandes de menu d'édition standard. A chaque commande de ce menu est associée une action standard (Annuler, Couper, Copier, etc.). Vous pouvez ajouter des commandes à ce menu ou utiliser vos propres méthodes de gestion des actions d'édition.
• Le menu Mode contient par défaut les commandes Structure, Utilisation et Menus créés. Ces commandes permettent d'accéder aux différents environnements de 4D à partir du mode Menus créés.
Note : 4e Dimension gère automatiquement les menus système Aide, Pomme (Mac OS) et application (Mac OS X). Ces menus ne peuvent pas être modifiés, hormis pour la commande A propos de 4e Dimension, qui peut être gérée à l'aide de la commande APPELER SUR A PROPOS.
Important : Les barres de menus sont "interprocess". Toute modification effectuée sur une barre sera répercutée dans tous les process où la barre est utilisée.
Numéros des menus et des commandes de menu
Comme les barres de menus, les menus sont numérotés. Le menu Fichier est le menu 1. Les autres menus sont numérotés séquentiellement de gauche à droite (2, 3, 4, etc.). La numérotation des menus est importante lorsque vous travaillez, par exemple, avec la fonction Menu choisi.
Lorsqu'un menu est associé à un formulaire, le principe de numérotation est différent. Le premier menu ajouté commence avec le numéro 2049. Pour référencer un menu associé à un formulaire, ajoutez 2048 au numéro initial du menu.
Les commandes de chacun des menus sont numérotées séquentiellement de haut en bas. La commande supérieure a le numéro 1.
Les barres de menus associées
Vous pouvez associer une barre de menus à un formulaire dans les Propriétés du formulaire (page Général). Ce type de barre est appelé "barre de menus de formulaire" dans cette section.
Les menus d'une barre de menus de formulaire sont ajoutés à la barre de menus courante lorsque le formulaire est affiché. Les menus sont ajoutés pour les formulaires entrée dans les modes Utilisation et Menus créés ainsi que pour les formulaires de sortie dans le mode Menus créés.
Les barres de menus de formulaires sont référencées par un numéro et un nom. Si le numéro ou le nom de la barre de menus affichée avec le formulaire courant est le même que celui de la barre de menus associée au formulaire, cette dernière ne s'affiche pas.
Par défaut, lorsqu'un formulaire est affiché avec une barre de menus personnalisée, les commandes de la barre de menus courante sont inactivées, c'est-à-dire que leur sélection est sans effet. Vous pouvez modifier ce fonctionnement en cochant l'option Barre de menus active dans les Propriétés du formulaire : dans ce cas, les commandes de la barre de menus courante restent utilisables.
Dans tous les cas, la sélection d'une commande de menu provoque l'envoi d'un événement Sur menu sélectionné à la méthode formulaire ; vous pouvez alors utiliser la commande Menu choisi pour tester le menu sélectionné.
Modifier des commandes de menu par programmation
4e Dimension fournit les commandes suivantes pour ajouter, supprimer, insérer ou modifier des commandes d'un menu de la barre affichée ou installée dans un process :
L'aire d'action de ces commandes est la barre de menus courante. Dès que vous appelez une nouvelle fois CHANGER BARRE, tous les menus et les commandes de menus retrouveront leur état originel tel qu'il est défini dans l'éditeur de barres de menus du mode Structure.
Vous devez passer à chacune de ces commandes un numéro de menu et un numéro de commande.
Comme expliqué plus haut, les menus sont numérotés de 1 à N de gauche à droite. Par exemple, le menu Fichier est généralement le premier menu. Les menus Pomme (Mac OS) et Application (Mac OS X) sont exclus de cette numérotation. Sur toutes les plates-formes, le menu Aide est également exclu.
Il est à noter que la commande Nombre de menus ne tient pas compte de ces menus. Si, par exemple, votre barre de menus est constituée des menus Fichier, Edition, Clients, Factures et Aide, Nombre de menus retournera 4 (en ignorant les menus système maintenus par 4D).
Les commandes de menus sont numérotées de 1 à N de haut en bas, y compris les séparateurs.
Les menus insérés dans la barre de menus au moyen d'une barre de menus associée à un formulaire (et donc ajoutée à la barre de menus courante) sont numérotés de gauche à droite et commencent par le numéro 2049 (2048 + 1 à N).
La commande Menu choisi retourne les numéros de menus et de commandes en respectant cette convention.
Important : Ces commandes n'ont pas accès aux menus système.
Menus connectés : Les menus peuvent être connectés à des barres de menu. Si un menu connecté est modifié à l'aide d'une de ces commandes, chacune des instances de ce menu reflètera ces modifications. Pour plus d'informations sur ce point, reportez-vous au manuel Mode Structure de 4e Dimension.
|
|
|
|
|
|
|
|
|
|