SET MENU ITEM PROPERTY

4D v20 R7


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	Texte, Numérique, Booléen	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 "Action standard"
n/a	Chaîne	4D_execute_without_validating	Activer l'option Exécuter sans valider (pour les éléments de menu associés aux actions standard). True=activé, False (par défaut)=désactivé
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

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

Dynamic pop up menu
GET MENU ITEM PROPERTY