FocusManager.FindNextFocusableElement 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
FindNextFocusableElement(FocusNavigationDirection) |
擷取應該根據指定的流覽方向接收焦點的專案。 |
FindNextFocusableElement(FocusNavigationDirection, Rect) |
擷取應該根據指定的流覽方向和提示矩形接收焦點的專案。 |
FindNextFocusableElement(FocusNavigationDirection)
擷取應該根據指定的流覽方向接收焦點的專案。
public:
static UIElement ^ FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("FindNextFocusableElement")]
static UIElement FindNextFocusableElement(FocusNavigationDirection const& focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("FindNextFocusableElement")]
public static UIElement FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection);
function findNextFocusableElement(focusNavigationDirection)
Public Shared Function FindNextFocusableElement (focusNavigationDirection As FocusNavigationDirection) As UIElement
參數
- focusNavigationDirection
- FocusNavigationDirection
焦點從專案移至應用程式 UI 內的元素方向。
傳回
null
如果無法以指定的方向設定焦點,則為 。
- 屬性
備註
您也可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法來以程式設計方式移動焦點。 這些方法會擷取元素 (為 DependencyObject) ,該元素只會根據指定的導覽方向 (方向流覽接收焦點,無法用來模擬索引標籤導覽) 。
注意
我們建議使用FindNextElement方法,而不是 FindNextFocusableElement
,因為 FindNextFocusableElement
會擷取 UIElement
,如果下一個 UIElement
可設定焦點的專案不是超連結物件) 之類的 (,則會傳回 。 null
另請參閱
適用於
FindNextFocusableElement(FocusNavigationDirection, Rect)
擷取應該根據指定的流覽方向和提示矩形接收焦點的專案。
public:
static UIElement ^ FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection, Rect hintRect);
/// [Windows.Foundation.Metadata.Overload("FindNextFocusableElementWithHint")]
static UIElement FindNextFocusableElement(FocusNavigationDirection const& focusNavigationDirection, Rect const& hintRect);
[Windows.Foundation.Metadata.Overload("FindNextFocusableElementWithHint")]
public static UIElement FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection, Rect hintRect);
function findNextFocusableElement(focusNavigationDirection, hintRect)
Public Shared Function FindNextFocusableElement (focusNavigationDirection As FocusNavigationDirection, hintRect As Rect) As UIElement
參數
- focusNavigationDirection
- FocusNavigationDirection
焦點從元素移至應用程式 UI 內的元素方向。
- hintRect
- Rect
周框,用來影響哪一個元素最有可能被視為接收焦點的下一個。 這非常有用的範例包括:
- 當目前沒有任何元素有焦點時,在螢幕位置指定 (-1、-1 的小型矩形,) 會從顯示器的左上角開始焦點。
- 在您想要確保目前時間的程式接收焦點的程式指南中。 (焦點演算法可能會根據許多因素,在稍後偏好顯示。)
傳回
null
如果無法以指定的方向設定焦點,則為 。
- 屬性
備註
您也可以使用 FindNextElement (FocusNavigationDirection、FindNextElementOptions) 方法或 FindNextElement (FocusNavigationDirection) 方法來以程式設計方式移動焦點。 這些方法會擷取元素 (為 DependencyObject) ,該元素只會根據指定的導覽方向 (方向流覽接收焦點,無法用來模擬索引標籤導覽) 。
注意
我們建議使用FindNextElement方法,而不是 FindNextFocusableElement
,因為 FindNextFocusableElement
會擷取 UIElement
,如果下一個 UIElement
可設定焦點的專案不是超連結物件) 之類的 (,則會傳回 。 null