IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Método

Definição

Namespace:

System.Windows.Interop

Assembly:

WindowsBase.dll

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);

public bool TranslateAccelerator (ref System.Windows.Interop.MSG msg, System.Windows.Input.ModifierKeys modifiers);

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

Boolean

true se a mensagem tiver sido manipulada pela implementação de método; caso contrário, false.

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.

Confira também

• TranslateChar(MSG, ModifierKeys)