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
Направление для прохождения (в порядке табуляции).
Возвращаемое значение
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)
- Взаимодействие с помощью клавиатуры
- Перемещение фокуса с помощью клавиатуры, геймпада, пульта дистанционного управления и средств специальных возможностей
- Программное перемещение фокуса
Применяется к
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
Параметры, помогающие определить следующий элемент для получения фокуса с помощью клавиатуры, контроллера или удаленной навигации.
Возвращаемое значение
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 ).
См. также раздел
- TryMoveFocus(FocusNavigationDirection)
- Взаимодействие с помощью клавиатуры
- Перемещение фокуса с помощью клавиатуры, геймпада, пульта дистанционного управления и средств специальных возможностей
- Программное перемещение фокуса
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по