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 элемент не является (например, объект Hyperlink ).

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

• 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 элемент не является (например, объект Hyperlink ).

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

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