IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Метод

Определение

Обрабатывает ввод от клавиатуры на уровне сообщений KEYDOWN.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

Параметры

msg
MSG

Сообщение и связанные с ним данные.The message and associated data. Не изменяйте эту структуру.Do not modify this structure. Она передается по ссылке исключительно по соображениям производительности.It is passed by reference for performance reasons only.

modifiers
ModifierKeys

Клавиши CTRL, SHIFT и ALT.Modifier keys.

Возвраты

true, если сообщение обработано данной реализацией метода; в противном случае — false.true if the message was handled by the method implementation; otherwise, false.

Атрибуты

Комментарии

Сообщение должно быть либо WM_KEYDOWN, либо WM_SYSKEYDOWN.The message must either be WM_KEYDOWN or WM_SYSKEYDOWN.

Если компонент не может выполнить обработку входных переводов и имеет дочерние компоненты, которые могут содержать переводы, TranslateAccelerator то обычно вызывает метод для дочернего компонента, который владеет текущим фокусом, прежде чем возвращать результат.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.

Если сообщение не может быть немедленно обработано, можно повторно отправить его из TranslateAccelerator реализации, если это необходимо, а затем вернуть. falseIf the message cannot be handled immediately, you can re-dispatch it from within the TranslateAccelerator implementation if necessary, and then return false.

Основным сценарием для перевода сочетаний клавиш является обработка сообщения VK_TAB KeyDown и определение необходимости установки фокуса в компоненте, вызова TabInto дочернего компонента или вызова OnNoMoreTabStops на родительском сайте, так как последовательность табуляции достиг границ начальной или конечной границы.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. Некоторые компоненты могут не обрабатывали клавишу TAB таким образом.Certain components may choose to not handle the tab key in this fashion.

Применяется к

Дополнительно