4D Doc Center : OBJET FIXER EQUIVALENT CLAVIER

4D v14.3

OBJET FIXER EQUIVALENT CLAVIER


OBJET FIXER 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 ou un champ
objet	Objet de formulaire	Nom d'objet (si * est spécifié) ou Variable ou champ (si * est omis)
touche	Chaîne	Touche à associer à l’objet
modifiers	Entier long	Masque ou combinaison de masques de touche(s) de modification

Description

La commande OBJET FIXER EQUIVALENT CLAVIER permet de définir ou de modifier dynamiquement l’équivalent clavier associé à l’objet ou aux objets désigné(s) par les paramètres objet et * pour le process courant.

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 ou un champ. Dans ce cas, vous ne passez pas un nom mais une référence.

Passez dans le paramètre touche une chaîne indiquant la touche du clavier à associer à l’objet. Vous pouvez passer soit :

un nom de touche standard, par exemple "B"

une constante du thème Touches équivalents clavier (ou sa valeur) :

Constante	Type	Valeur	Commentaire
Raccourci avec Aide	Chaîne	[help]
Raccourci avec Début	Chaîne	[home]
Raccourci avec Echappement	Chaîne	[esc]
Raccourci avec Effacement arrière	Chaîne	[backspace]
Raccourci avec Entrée	Chaîne	[enter]
Raccourci avec F1	Chaîne	[F1]
Raccourci avec F10	Chaîne	[F10]
Raccourci avec F11	Chaîne	[F11]
Raccourci avec F12	Chaîne	[F12]
Raccourci avec F13	Chaîne	[F13]
Raccourci avec F14	Chaîne	[F14]
Raccourci avec F15	Chaîne	[F15]
Raccourci avec F2	Chaîne	[F2]
Raccourci avec F3	Chaîne	[F3]
Raccourci avec F4	Chaîne	[F4]
Raccourci avec F5	Chaîne	[F5]
Raccourci avec F6	Chaîne	[F6]
Raccourci avec F7	Chaîne	[F7]
Raccourci avec F8	Chaîne	[F8]
Raccourci avec F9	Chaîne	[F9]
Raccourci avec Fin	Chaîne	[end]
Raccourci avec Flèche bas	Chaîne	[down arrow]
Raccourci avec Flèche droite	Chaîne	[right arrow]
Raccourci avec Flèche gauche	Chaîne	[left arrow]
Raccourci avec Flèche haut	Chaîne	[up arrow]
Raccourci avec Page préc	Chaîne	[page up]
Raccourci avec Page suiv	Chaîne	[page down]
Raccourci avec Retour Chariot	Chaîne	[return]
Raccourci avec Suppression	Chaîne	[del]
Raccourci avec Tabulation	Chaîne	[tab]

Passez dans le paramètre modifiers une ou plusieurs touche(s) de modification à associer à la touche de raccourci. Pour définir le paramètre modifiers, passez une ou plusieurs des constante(s) de type "Masque" 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

Note : Si vous omettez le paramètre modifiers, l’objet sera activé dès que vous appuierez sur la touche définie. Par exemple, si vous avez associé la touche "H" à un bouton, il sera activé dès que vous appuierez sur la touche H. Ce fonctionnement est à réserver à des interfaces spécifiques.

Exemple

Vous voulez associer un équivalent clavier différent en fonction de la langue courante de l’application. Dans l’événement sur chargement du formulaire, vous pouvez écrire :

 Au cas ou

    :(vLang="FR")

       OBJET FIXER EQUIVALENT CLAVIER(*;"SortButton";"T";Masque touche commande+Masque touche majuscule)

  // Ctrl+Maj+T en français

    :(vLang="US")

       OBJET FIXER EQUIVALENT CLAVIER(*;"SortButton";"O";Masque touche commande+Masque touche majuscule)

  // Ctrl+Maj+O en anglais

 Fin de cas