IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Método

Definição

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.

Aplica-se a

Ver também