IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Metoda

Definicja

Przetwarza dane wejściowe z klawiatury na poziomie komunikatu KeyDown.Processes keyboard input at the keydown message level.

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);
[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
[<System.Security.SecurityCritical>]
abstract member TranslateAccelerator : MSG * System.Windows.Input.ModifierKeys -> bool
Public Function TranslateAccelerator (ByRef msg As MSG, modifiers As ModifierKeys) As Boolean

Parametry

msg
MSG

Komunikat i powiązane dane.The message and associated data. Nie należy modyfikować tej struktury.Do not modify this structure. Jest ona przesyłana przez odwołanie wyłącznie do powodów związanych z wydajnością.It is passed by reference for performance reasons only.

modifiers
ModifierKeys

Klawisze modyfikujące.Modifier keys.

Zwraca

Boolean

true Jeśli komunikat został obsłużony przez implementację metody; w przeciwnym razie false .true if the message was handled by the method implementation; otherwise, false.

Atrybuty

Uwagi

Komunikat musi mieć wartość WM_KEYDOWN lub WM_SYSKEYDOWN.The message must either be WM_KEYDOWN or WM_SYSKEYDOWN.

Jeśli składnik nie może obsłużyć tłumaczeń wejściowych i ma składniki podrzędne, które mogą mieć tłumaczenia, zazwyczaj wywołuje TranslateAccelerator metodę w składniku podrzędnym, który posiada bieżący fokus przed zwróceniem wyniku.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.

Jeśli komunikat nie może być obsłużony natychmiast, można go ponownie wysłać z poziomu TranslateAccelerator implementacji, jeśli jest to konieczne, a następnie zwrócić false .If the message cannot be handled immediately, you can re-dispatch it from within the TranslateAccelerator implementation if necessary, and then return false.

Głównym scenariuszem translacji klawiszy akceleratora jest obsługa komunikatu o VK_TAB KeyDown i określanie, czy należy ustawić fokus w składniku, aby wywołać TabInto składnik podrzędny lub wywołać OnNoMoreTabStops w lokacji nadrzędnej, ponieważ sekwencja kart osiągnęła wartość początkową lub końcową.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. Niektóre składniki mogą zrezygnować z obsługi klawisza Tab w ten sposób.Certain components may choose to not handle the tab key in this fashion.

Dotyczy

Zobacz też