IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Método

Definição

Processa a entrada do teclado no nível da mensagem por pressionamento de tecla.Processes keyboard input at the keydown message level.

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);
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.The message and associated data. Não modifique esta estrutura.Do not modify this structure. É passado por referência apenas por razões de desempenho.It is passed by reference for performance reasons only.

modifiers
ModifierKeys

Teclas modificadoras.Modifier keys.

Retornos

true se a mensagem tiver sido manipulada pela implementação de método; caso contrário, false.true if the message was handled by the method implementation; otherwise, false.

Atributos

Comentários

A mensagem deve ser WM_KEYDOWN ou WM_SYSKEYDOWN.The message must either be WM_KEYDOWN or WM_SYSKEYDOWN.

Se o componente não puder lidar com as traduções de entrada e tiver componentes filho que possam ter traduções, TranslateAccelerator ele normalmente chamará o método no componente filho que mantém o foco atual antes de retornar um resultado.If the component is unable to handle the input translations and has child components that might have translations, it typically calls TranslateAccelerator method on the child component that holds the current focus before returning a result.

Se a mensagem não puder ser manipulada imediatamente, você poderá redistribuí-la de TranslateAccelerator dentro da implementação, se necessário, falsee, em seguida, retornar.If the message cannot be handled immediately, you can re-dispatch it from within the TranslateAccelerator implementation if necessary, and then return false.

Um cenário principal para converter chaves Aceleradoras é manipular a mensagem VK_TAB KeyDown e determinar se o foco deve ser definido no componente, chamar TabInto para um componente filho ou chamar OnNoMoreTabStops no site pai, pois a sequência de tabulação atingiu os limites de início ou término.A primary scenario for translating accelerator keys is handling the VK_TAB keydown message and determining whether to set focus within the component, to call TabInto to a child component, or to call OnNoMoreTabStops on the parent site because the tab sequence has reached the beginning or end bounds. Alguns componentes podem optar por não lidar com a tecla Tab dessa maneira.Certain components may choose to not handle the tab key in this fashion.

Aplica-se a

Veja também