IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Processa a entrada do teclado no nível da mensagem por pressionamento de tecla.
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
Parâmetros
- msg
- MSG
A mensagem e seus dados associados. Não modifique esta estrutura. É passado por referência apenas por razões de desempenho.
- modifiers
- ModifierKeys
Teclas modificadoras.
Retornos
true
se a mensagem tiver sido manipulada pela implementação de método; caso contrário, false
.
- Atributos
Comentários
A mensagem deve ser WM_KEYDOWN ou WM_SYSKEYDOWN.
Se o componente não conseguir lidar com as traduções de entrada e tiver componentes filho que possam ter traduções, ele normalmente chamará TranslateAccelerator o método no componente filho que mantém o foco atual antes de retornar um resultado.
Se a mensagem não puder ser tratada imediatamente, você poderá reemplá-la de dentro da TranslateAccelerator implementação, se necessário, e retornar false
.
Um cenário principal para traduzir chaves de acelerador é lidar com o VK_TAB mensagem de keydown e determinar se deseja definir o foco dentro do componente, chamar TabInto para um componente filho ou chamar OnNoMoreTabStops no site pai porque a sequência de guias atingiu os limites de início ou final. Determinados componentes podem optar por não manipular a tecla tab dessa forma.