IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Traite l'entrée au clavier au niveau du message keydown.
public:
bool TranslateAccelerator(System::Windows::Interop::MSG % msg, System::Windows::Input::ModifierKeys modifiers);
[System.Security.SecurityCritical]
public bool TranslateAccelerator (ref System.Windows.Interop.MSG msg, System.Windows.Input.ModifierKeys modifiers);
public bool TranslateAccelerator (ref System.Windows.Interop.MSG msg, System.Windows.Input.ModifierKeys modifiers);
[<System.Security.SecurityCritical>]
abstract member TranslateAccelerator : MSG * System.Windows.Input.ModifierKeys -> bool
abstract member TranslateAccelerator : MSG * System.Windows.Input.ModifierKeys -> bool
Public Function TranslateAccelerator (ByRef msg As MSG, modifiers As ModifierKeys) As Boolean
Paramètres
- msg
- MSG
Message et données associées. Ne modifiez pas cette structure. Elle est passée par référence pour des raisons de performances uniquement.
- modifiers
- ModifierKeys
Touches de modification.
Retours
true
si le message a été géré par l'implémentation de la méthode ; sinon, false
.
- Attributs
Remarques
Le message doit être WM_KEYDOWN ou WM_SYSKEYDOWN.
Si le composant ne peut pas gérer les traductions d’entrée et a des composants enfants qui peuvent avoir des traductions, il appelle TranslateAccelerator généralement la méthode sur le composant enfant qui maintient le focus actuel avant de retourner un résultat.
Si le message ne peut pas être géré immédiatement, vous pouvez le redéployer à partir de l’implémentation TranslateAccelerator si nécessaire, puis retourner false
.
Un scénario principal pour la traduction des touches d’accélérateur consiste à gérer le message VK_TAB keydown et à déterminer s’il faut définir le focus dans le composant, appeler TabInto un composant enfant ou appeler OnNoMoreTabStops sur le site parent, car la séquence d’onglets a atteint les limites de début ou de fin. Certains composants peuvent choisir de ne pas gérer la touche tabulation de cette façon.