IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) IKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys) Method

定義

キー押下メッセージのレベルでキーボード入力を処理します。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 MSG MSG MSG

メッセージおよび関連付けられたデータ。The message and associated data. この構造体を変更しないでください。Do not modify this structure. パフォーマンス上の理由から、これは参照渡しのみです。It is passed by reference for performance reasons only.

modifiers
ModifierKeys ModifierKeys ModifierKeys ModifierKeys

変換キー。Modifier keys.

戻り値

メッセージがメソッドの実装によって処理された場合は true。それ以外の場合は falsetrue 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実装内から再ディスパッチし、を返すfalseことができます。If 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.

適用対象

こちらもご覧ください