FocusManager.TryMoveFocus 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
TryMoveFocus(FocusNavigationDirection) |
嘗試將焦點從具有焦點的專案變更為指定方向的下一個可焦點專案。 |
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions) |
嘗試使用指定的導覽選項,將焦點從焦點專案變更為指定方向的下一個可焦點專案。 |
TryMoveFocus(FocusNavigationDirection)
嘗試將焦點從具有焦點的專案變更為指定方向的下一個可焦點專案。
public:
static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
static bool TryMoveFocus(FocusNavigationDirection const& 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
另請參閱
- 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
。
- 屬性
備註
定位順序是使用者按下 Tab 鍵 (向前移動) 或 Shift+Tab (向後) ,讓使用者從一個控制項移到另一個控制項的順序。
這個方法會使用定位順序順序和行為來周遊 UI 中所有可設定焦點的專案。
- 如果焦點位於定位順序中的第一個專案,而且指定 FocusNavigationDirection.Previous ,焦點會移至最後一個專案。
- 如果焦點位於定位順序中的最後一個專案,而且指定 FocusNavigationDirection.Next ,焦點會移至第一個專案。
您也可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法來以程式設計方式移動焦點。 這些方法會擷取元素 (為 DependencyObject) ,該元素只會根據指定的導覽方向 (方向流覽接收焦點,無法用來模擬索引標籤導覽) 。
注意
我們建議使用FindNextElement方法,而不是 FindNextFocusableElement
,因為 FindNextFocusableElement
會擷取 UIElement
,如果下一個 UIElement
可設定焦點的專案不是超連結物件) 之類的 (,則會傳回 。 null