FocusManager.TryMoveFocus 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 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
依定位順序周遊 (的方向) 。
傳回
bool
如果焦點移動，則為 true;否則為false。
- 屬性
備註
定位順序是使用者按下 Tab 鍵 (向前移動) 或 Shift+Tab (向後) ，讓使用者從一個控制項移到另一個控制項的順序。
這個方法會使用定位順序順序和行為來周遊 UI 中所有可設定焦點的專案。
如果焦點位於定位順序中的第一個專案，而且指定 FocusNavigationDirection.Previous ，焦點會移至最後一個專案。
如果焦點位於定位順序中的最後一個專案，而且指定 FocusNavigationDirection.Next ，焦點會移至第一個專案。
您也可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法來以程式設計方式移動焦點。 這些方法會擷取元素 (為 DependencyObject) ，該元素只會根據指定的導覽方向 (方向流覽接收焦點，無法用來模擬索引標籤導覽) 。
注意
我們建議使用 FindNextElement 方法，而不是 FindNextFocusableElement，因為 FindNextFocusableElement 會擷取 UIElement，如果下一個可設定焦點的專案不是 UIElement (，則會傳回 null，例如 Hyperlink 物件) 。
另請參閱
- TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)
- 鍵盤互動
- 適用於鍵盤、遊戲台、遠端控制與協助工具的焦點瀏覽
- 程式設計焦點瀏覽
適用於
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
可協助識別下一個專案以鍵盤/控制器/遠端流覽接收焦點的選項。
傳回
bool
如果焦點移動，則為 true;否則為false。
- 屬性
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 物件) 。