FrameworkElement.MoveFocus(TraversalRequest) メソッド

定義

キーボード フォーカスをこの要素から離し、指定されたトラバーサル方向の別の要素に移動します。

public:
 override bool MoveFocus(System::Windows::Input::TraversalRequest ^ request);
public override sealed bool MoveFocus(System.Windows.Input.TraversalRequest request);
override this.MoveFocus : System.Windows.Input.TraversalRequest -> bool
Public Overrides NotOverridable Function MoveFocus (request As TraversalRequest) As Boolean

パラメーター

request
TraversalRequest

列挙体の値として、フォーカスを移動する方向。

返品

フォーカスが正常に移動された場合に true を返します。指定した方向のターゲット要素が存在しないか、キーボードフォーカスできなかった場合に false します。

次の例では、いくつかのボタン入力を処理するハンドラーを実装します。 各ボタンは、使用可能な FocusNavigationDirectionを表します。 ハンドラーは、現在のキーボード フォーカスを持つ要素を追跡し、指定されたTraversalRequest型パラメーターの初期化として適切なFocusNavigationDirectionを指定して、その要素にMoveFocusを呼び出します。

// Creating a FocusNavigationDirection object and setting it to a
// local field that contains the direction selected.
FocusNavigationDirection focusDirection = _focusMoveValue;

// MoveFocus takes a TraveralReqest as its argument.
TraversalRequest request = new TraversalRequest(focusDirection);

// Gets the element with keyboard focus.
UIElement elementWithFocus = Keyboard.FocusedElement as UIElement;

// Change keyboard focus.
if (elementWithFocus != null)
{
    elementWithFocus.MoveFocus(request);
}
' Creating a FocusNavigationDirection object and setting it to a
' local field that contains the direction selected.
Dim focusDirection As FocusNavigationDirection = _focusMoveValue

' MoveFocus takes a TraveralReqest as its argument.
Dim request As New TraversalRequest(focusDirection)

' Gets the element with keyboard focus.
Dim elementWithFocus As UIElement = TryCast(Keyboard.FocusedElement, UIElement)

' Change keyboard focus.
If elementWithFocus IsNot Nothing Then
    elementWithFocus.MoveFocus(request)
End If

注釈

この実装は、 UIElement.MoveFocus をオーバーライドし、メソッドをシールします。

適用対象

こちらもご覧ください