IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Processa a entrada do teclado ao nível da mensagem de tecla para baixo.
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 os dados associados. Não modifiquem esta estrutura. É transmitido por referência apenas por razões de desempenho.
- modifiers
- ModifierKeys
Teclas modificadoras.
Devoluções
true se a mensagem foi tratada pela implementação do método; caso contrário, false.
- Atributos
Observações
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 filhos que possam ter translações, normalmente chama TranslateAccelerator o método no componente filho que detém o foco atual antes de devolver um resultado.
Se a mensagem não puder ser tratada imediatamente, pode despachá-la novamente a partir da TranslateAccelerator implementação, se necessário, e depois devolver false.
Um cenário principal para traduzir chaves aceleradoras é lidar com a mensagem VK_TAB keydown e determinar se definir o foco dentro do componente, chamar TabInto a um componente filho ou OnNoMoreTabStops apelar no site pai porque a sequência de tabulação atingiu os limites iniciais ou finais. Certos componentes podem optar por não gerir a tecla tab desta forma.