Поделиться через


FocusManager.TryMoveFocus Метод

Определение

Перегрузки

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

Направление для прохождения (в порядке табуляции).

Возвращаемое значение

Boolean

bool

Значение true , если фокус перемещен; в противном случае — false.

Атрибуты

Комментарии

Порядок табуляции — это порядок перемещения пользователя от одного элемента управления к другому нажатием клавиши TAB (вперед) или SHIFT+TAB (назад).

Этот метод использует последовательность табуляции и поведение для обхода всех элементов, доступных для фокусировки в пользовательском интерфейсе.

Если фокус находится на первом элементе в последовательности табуляции и указан параметр FocusNavigationDirection.Previous , фокус перемещается на последний элемент.

Если фокус находится на последнем элементе в последовательности табуляции и указан FocusNavigationDirection.Next , фокус перемещается на первый элемент.

Для программного перемещения фокуса можно также использовать метод FindNextElement(FocusNavigationDirection, FindNextElementOptions) или Метод FindNextElement(FocusNavigationDirection). Эти методы извлекают элемент (в виде DependencyObject), который будет получать фокус на основе указанного направления навигации (только направленная навигация, не может использоваться для эмуляции навигации по вкладкам).

Примечание

Мы рекомендуем использовать метод FindNextElement вместо FindNextFocusableElement, так как FindNextFocusableElement извлекает UIElement, который возвращает значение NULL, если следующий фокусируемый элемент не является элементом UIElement (например , объектом Hyperlink ).

См. также раздел

Применяется к

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

Параметры, помогающие определить следующий элемент для получения фокуса с помощью клавиатуры, контроллера или удаленной навигации.

Возвращаемое значение

Boolean

bool

Значение true , если фокус перемещен; в противном случае — false.

Атрибуты

Требования к Windows

Семейство устройств
Windows 10 Creators Update (появилось в 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v4.0)

Комментарии

Порядок табуляции — это порядок перемещения пользователя от одного элемента управления к другому нажатием клавиши TAB (вперед) или SHIFT+TAB (назад).

Этот метод использует последовательность табуляции и поведение для обхода всех элементов, доступных для фокусировки в пользовательском интерфейсе.

Если фокус находится на первом элементе в последовательности табуляции и указан параметр FocusNavigationDirection.Previous , фокус перемещается на последний элемент.

Если фокус находится на последнем элементе в последовательности табуляции и указан FocusNavigationDirection.Next , фокус перемещается на первый элемент.

Для программного перемещения фокуса можно также использовать метод FindNextElement(FocusNavigationDirection, FindNextElementOptions) или Метод FindNextElement(FocusNavigationDirection). Эти методы извлекают элемент (в виде DependencyObject), который будет получать фокус на основе указанного направления навигации (только направленная навигация, не может использоваться для эмуляции навигации по вкладкам).

Примечание

Мы рекомендуем использовать метод FindNextElement вместо FindNextFocusableElement, так как FindNextFocusableElement извлекает UIElement, который возвращает значение NULL, если следующий фокусируемый элемент не является элементом UIElement (например , объектом Hyperlink ).

См. также раздел

Применяется к