Aller au contenu principal
Version: Next

OBJECT GET SHORTCUT

OBJECT GET SHORTCUT ( {* ;} objet ; touche ; modifiers )

ParamètreTypeDescription
*OpérateurSi spécifié, objet est un nom d'objet (chaîne)
Si omis, objet est une variable
objetanyNom d’objet (si * est spécifié) ou
Variable (si * est omis)
toucheTextTouche associée à l’objet
modifiersIntegerMasque ou combinaison de masques de touche(s) de modification

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

Description

La commande OBJECT GET SHORTCUT retourne l’équivalent clavier associé à l’objet ou aux objets désigné(s) par les paramètres objet et *.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable.

Le paramètre touche retourne le caractère associé à la touche (dans le cas d’une touche standard) ou une chaîne entre crochets désignant la touche (dans le cas d’une touche de fonction). Vous pouvez comparer cette valeur aux constantes du thème Touches équivalents clavier (cf. commande OBJECT SET SHORTCUT).

Le paramètre modifiers retourne une valeur indiquant la ou les touche(s) de modification associée(s) à l’équivalent clavier. Si plusieurs touches de modification ont été combinées, la commande retourne le cumul de leurs valeurs. Vous pouvez comparer la valeur reçue aux constantes suivantes du thème Evénements (Modifiers) :

ConstanteTypeValeurComment
Command key maskEntier long256Touche Ctrl sous Windows, touche Commande sous OS X
Control key maskEntier long4096Touche Ctrl sous OS X, ou clic droit sous Windows et OS X
Option key maskEntier long2048Touche Alt (aussi appelée Option sous OS X)
Shift key maskEntier long512Windows et OS X

Si aucune touche de modification n’a été définie dans l’équivalent clavier, modifiers retourne 0.

Note : Si le paramètre objet désigne plusieurs objets du formulaire ayant des paramétrages différents, la commande retourne "" dans touche et 0 dans modifiers.

Voir aussi

OBJECT SET SHORTCUT