FocusManager.TryMoveFocus Метод

Определение

Пространство имен:

Microsoft.UI.Xaml.Input

Перегрузки

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

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

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

Boolean

bool

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

Атрибуты

OverloadAttribute

Комментарии

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

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

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

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

Заметка

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

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

• 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

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

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

Boolean

bool

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

Атрибуты

OverloadAttribute

Комментарии

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

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

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

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

Заметка

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

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

• TryMoveFocus(FocusNavigationDirection)
• взаимодействия клавиатуры
• Навигация фокуса для клавиатуры, геймпада, удаленного управления и специальных возможностей
• навигация программного фокуса