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 物件)。