FocusManager.TryMoveFocus 方法

  • 參考

定義

命名空間:
Windows.UI.Xaml.Input

多載

TryMoveFocus(FocusNavigationDirection)

嘗試將焦點從具有焦點的專案變更為指定方向的下一個可焦點專案。
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

嘗試使用指定的導覽選項，將焦點從焦點專案變更為指定方向的下一個可焦點專案。

TryMoveFocus(FocusNavigationDirection)

編輯

嘗試將焦點從具有焦點的專案變更為指定方向的下一個可焦點專案。

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
function tryMoveFocus(focusNavigationDirection)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As Boolean

參數

focusNavigationDirection
FocusNavigationDirection

依定位順序周遊 (的方向) 。

傳回

Boolean

bool

如果焦點移動，則為 true;否則為false。

屬性
OverloadAttribute

備註

定位順序是使用者按下 Tab 鍵 (向前移動) 或 Shift+Tab (向後) ，讓使用者從一個控制項移到另一個控制項的順序。

這個方法會使用定位順序順序和行為來周遊 UI 中所有可設定焦點的專案。

如果焦點位於定位順序中的第一個專案，而且指定 FocusNavigationDirection.Previous ，焦點會移至最後一個專案。

如果焦點位於定位順序中的最後一個專案，而且指定 FocusNavigationDirection.Next ，焦點會移至第一個專案。

您也可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法來以程式設計方式移動焦點。 這些方法會擷取元素 (為 DependencyObject) ，該元素只會根據指定的導覽方向 (方向流覽接收焦點，無法用來模擬索引標籤導覽) 。

注意

我們建議使用 FindNextElement 方法，而不是 FindNextFocusableElement，因為 FindNextFocusableElement 會擷取 UIElement，如果下一個可設定焦點的專案不是 UIElement (，則會傳回 null，例如 Hyperlink 物件) 。

另請參閱

適用於

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

編輯

嘗試使用指定的導覽選項，將焦點從焦點專案變更為指定方向的下一個可焦點專案。

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions ^ focusNavigationOptions);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection, FindNextElementOptions const& focusNavigationOptions);
[Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions focusNavigationOptions);
function tryMoveFocus(focusNavigationDirection, focusNavigationOptions)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection, focusNavigationOptions As FindNextElementOptions) As Boolean

參數

focusNavigationDirection
FocusNavigationDirection

依定位順序周遊 (的方向) 。

focusNavigationOptions
FindNextElementOptions

可協助識別下一個專案以鍵盤/控制器/遠端流覽接收焦點的選項。

傳回

Boolean

bool

如果焦點移動，則為 true;否則為false。

屬性
OverloadAttribute

Windows 需求

裝置系列
Windows 10 Creators Update (已於 10.0.15063.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v4.0 引進)

備註

定位順序是使用者按下 Tab 鍵 (向前移動) 或 Shift+Tab (向後) ，讓使用者從一個控制項移到另一個控制項的順序。

這個方法會使用定位順序順序和行為來周遊 UI 中所有可設定焦點的專案。

如果焦點位於定位順序中的第一個專案，而且指定 FocusNavigationDirection.Previous ，焦點會移至最後一個專案。

如果焦點位於定位順序中的最後一個專案，而且指定 FocusNavigationDirection.Next ，焦點會移至第一個專案。

您也可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法來以程式設計方式移動焦點。 這些方法會擷取元素 (為 DependencyObject) ，該元素只會根據指定的導覽方向 (方向流覽接收焦點，無法用來模擬索引標籤導覽) 。

注意

我們建議使用 FindNextElement 方法，而不是 FindNextFocusableElement，因為 FindNextFocusableElement 會擷取 UIElement，如果下一個可設定焦點的專案不是 UIElement (，則會傳回 null，例如 Hyperlink 物件) 。

另請參閱

適用於