4D Doc Center : OBJET LIRE EQUIVALENT CLAVIER

4D v14.3

OBJET LIRE EQUIVALENT CLAVIER


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	Commentaire
Masque touche commande	Entier long	256	Windows = touche Ctrl, Mac OS = touche Commande
Masque touche contrôle	Entier long	4096	Mac OS uniquement
Masque touche majuscule	Entier long	512	Windows et Mac OS
Masque touche option	Entier long	2048	Windows = touche Alt, Mac OS = touche Option

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.