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,例如 Hyperlink 物件) 。
另請參閱
適用於
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,例如 Hyperlink 物件) 。