SET MENU ITEM PROPERTY

4D v16.3


SET MENU ITEM PROPERTY ( menu ; ligneMenu ; propriété ; valeur {; process} )

Paramètre	Type	Description
menu	Entier long, RefMenu	Référence de menu ou Numéro de menu
ligneMenu	Entier long	Numéro de ligne de menu ou -1 pour la dernière ligne ajoutée au menu
propriété	Chaîne	Type de propriété
valeur	Expression	Valeur de la propriété
process	Entier long	Numéro de process

Description

La commande SET MENU ITEM PROPERTY permet de fixer la valeur de la propriété pour la ligne de menu désignée par les paramètres menu et ligneMenu.
Vous pouvez passer -1 dans ligneMenu afin de désigner la dernière ligne ajoutée au menu.

Vous pouvez passer dans menu un identifiant unique de menu (RefMenu) ou un numéro de menu. Si vous passez un identifiant unique, la commande s’appliquera à toutes les instances du menu dans tous les process. Dans ce cas, le paramètre process est ignoré s’il est passé. Si vous passez un numéro de menu, la commande s’appliquera au menu correspondant dans la barre de menus principale du process courant. Si vous souhaitez désigner un autre process, passez son numéro dans le paramètre facultatif process.

Passez dans le paramètre propriété la propriété dont vous souhaitez modifier la valeur et dans valeur, la nouvelle valeur. Pour le paramètre propriété, vous pouvez utiliser l’une des constantes du thème “Propriétés des lignes de menu” ou toute valeur personnalisée :

Propriété standard : les constantes du thème “Propriétés des lignes de menu” ainsi que leurs valeurs possibles sont décrites ci-dessous. A noter que dans le cas de la propriété Associated standard action, vous pouvez passer une des constantes du thème “Valeurs pour Actions standard associée” dans le paramètre valeur.

Constante	Type	Valeur	Comment
Access privileges	Chaîne	4D_access_group	Affecter un groupe d’accès à la commande 0 = Sans restriction >0 = Numéro de groupe
Associated standard action	Chaîne	4D_standard_action	Associer une action standard à la ligne de menu Voir les constantes du thème "Valeurs pour Actions standard associée"
Start a new process	Chaîne	4D_start_new_process	Activer l’option "Démarrer un nouveau process" 0 = Non, 1 = Oui

Voici les constantes du thème "Valeurs pour Actions standard associée" :

Constante	Type	Valeur
Accept action	Entier long	2
Add subrecord action	Entier long	14
Cancel action	Entier long	1
Clear action	Entier long	21
Copy action	Entier long	19
Cut action	Entier long	18
Database settings action	Entier long	32
Delete record action	Entier long	7
Delete subrecord action	Entier long	13
Edit subrecord action	Entier long	12
First page action	Entier long	10
First record action	Entier long	5
Last page action	Entier long	11
Last record action	Entier long	6
MSC action	Entier long	36
Next page action	Entier long	8
Next record action	Entier long	3
No action	Entier long	0
Paste action	Entier long	20
Previous page action	Entier long	9
Previous record action	Entier long	4
Quit action	Entier long	27
Redo action	Entier long	31
Return to Design mode	Entier long	35
Select all action	Entier long	22
Show clipboard action	Entier long	23
Test application action	Entier long	26
Undo action	Entier long	17

Pour plus d’informations sur les propriétés standard des lignes de menus, reportez-vous au chapitre “Créer des menus personnalisés” dans le manuel Mode Développement.

Propriété personnalisée : vous pouvez passer dans propriété tout texte personnalisé et lui associer une valeur de type texte, numérique ou booléen. Cette valeur sera stockée avec l’élément et pourra être récupérée via la commande GET MENU ITEM PROPERTY. Vous pouvez utiliser toute chaîne personnalisée dans le paramètre propriété, veillez simplement à ne pas utiliser de libellé utilisé par 4D (par convention, les propriétés définies par 4D débutent par les caractères “4D_”).

Note : Si la ligne de menu correspond au libellé d’un sous-menu hiérarchique, l’action standard ne sera pas appelée lorsque la ligne de menu sera sélectionnée.

Voir aussi

GET MENU ITEM PROPERTY