OBJET LIRE EQUIVALENT CLAVIER

4D v16.3


OBJET LIRE EQUIVALENT CLAVIER ( {* ;} objet ; touche ; modifiers )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d’objet (si * est spécifié) ou Variable (si * est omis)
touche	Chaîne	Touche associée à l’objet
modifiers	Entier long	Masque ou combinaison de masques de touche(s) de modification

Description

La commande OBJET LIRE EQUIVALENT CLAVIER 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 OBJET FIXER EQUIVALENT CLAVIER).

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) :

Constante	Type	Valeur	Comment
Masque touche commande	Entier long	256	Touche Ctrl sous Windows, touche Commande sous OS X
Masque touche contrôle	Entier long	4096	Touche Ctrl sous OS X, ou clic droit sous Windows et OS X
Masque touche majuscule	Entier long	512	Windows et OS X
Masque touche option	Entier long	2048	Touche Alt (aussi appelée Option sous 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

OBJET FIXER EQUIVALENT CLAVIER