Aller au contenu principal
Version: Next

SET MENU ITEM PROPERTY

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

ParamètreTypeDescription
menuInteger, TextRéférence de menu ou Numéro de menu
ligneMenuIntegerNuméro de ligne de menu ou -1 pour la dernière ligne ajoutée au menu
propriétéTextType de propriété
valeurText, Number, BooleanValeur de la propriété
processIntegerNuméro de process

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

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.

ConstanteTypeValeurComment
Access privilegesChaîne4D_access_groupAffecter un groupe d’accès à la commande
0 = Sans restriction
>0 = Numéro de groupe
Associated standard actionChaîne4D_standard_actionAssocier une action standard à la ligne de menu
Voir les constantes du thème "Action standard"
n/aChaîne4D_execute_without_validatingActiver 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 processChaîne4D_start_new_processActiver l’option "Démarrer un nouveau process"
0 = Non, 1 = Oui

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

ConstanteTypeValeur

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