4D Doc Center : INSERER LIGNE MENU

4D v14.3

INSERER LIGNE MENU


INSERER LIGNE MENU ( menu ; aprèsLigne ; libelléElément {; sousMenu {; process}}{; *} )

Paramètre	Type	Description
menu	Entier long, RefMenu	Numéro de menu ou Référence de menu
aprèsLigne	Entier long	Numéro de commande de menu
libelléElément	Chaîne	Libellé de la ligne de menu à insérer
sousMenu	RefMenu	Référence du sous-menu associé à la ligne
process	Entier long	Numéro de référence de process
*	Opérateur	Si passé : considérer les métacaractères comme des caractères standard

Description

La commande INSERER LIGNE MENU insère de nouvelles lignes dans le menu dont vous avez passé le numéro ou la référence dans menu et les place après la ligne de menu dont le numéro est passé dans aprèsLigne.

Si vous ne passez pas le paramètre process, INSERER LIGNE MENU est appliquée à la barre de menus du process courant. Sinon, INSERER LIGNE MENU est appliquée à la barre de menus du process dont la référence est passée dans process.

Note : Si vous passez un paramètre RefMenu dans menu, le paramètre process est inutile et sera ignoré.

Si vous ne passez pas le paramètre *, INSERER LIGNE MENU vous permet d'insérer une ou plusieurs lignes de menus en une seule fois.

INSERER LIGNE MENU fonctionne comme AJOUTER LIGNE MENU, hormis le fait qu'elle permet d'insérer des commandes de menu partout dans le menu alors que AJOUTER LIGNE MENU les ajoute toujours à la fin du menu.

Reportez-vous à la description de la commande AJOUTER LIGNE MENU pour plus de détails sur la définition des commandes de menus passée dans libelléLigne et sur l'action du paramètre *.

Le paramètre facultatif sousMenu vous permet de désigner un menu comme ligne insérée et donc de définir un sous-menu hiérarchique. Vous devez passer dans ce paramètre une référence de menu (chaîne de type RefMenu) désignant un menu créé par exemple à l’aide de la commande Creer menu. Si la commande insère plusieurs lignes de menus, le sous-menu est associé à la première ligne.

Important : Les nouvelles lignes n'ont pas de méthodes ou d'actions associées. Vous devez leur associer une action ou une méthode via les commandes FIXER PROPRIETE LIGNE MENU ou FIXER METHODE LIGNE MENU ou encore les gérer à partir d'une méthode formulaire qui utilise la fonction Menu choisi.

Exemple

L’exemple suivant crée un menu constitué de deux commandes auxquelles il affecte une méthode :

 refMenu:=Creer menu

 AJOUTER LIGNE MENU(refMenu;"Caractères")

 FIXER METHODE LIGNE MENU(refMenu;1;"GestCaracDial")

 INSERER LIGNE MENU(refMenu;1;"Paragraphes")

 FIXER METHODE LIGNE MENU(refMenu;2;"GestParDial")