Vous êtes sur le site Web historique de la documentation de 4D. Les documentations sont progressivement déplacées vers developer.4d.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v20 R7
INSERER LIGNE MENU
|
INSERER LIGNE MENU ( menu ; aprèsLigne ; libelléElément {; sousMenu {; process}}{; *} ) | ||||||||
Paramètre | Type | Description | ||||||
menu | Entier long |
![]() |
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 | |||||
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 *.
Note : La constante ak standard action title est prise en charge dans le paramètre libelléLigne (4D v16 R3 et suivantes).
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.
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")
Produit : 4D
Thème : Menus
Numéro :
412
Nom intl. : INSERT MENU ITEM
Modifié : 4D v11 SQL Release 4
Modifié : 4D v16 R3
4D - Langage ( 4D v20 R7)