FocusManager.FindNextFocusableElement Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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
Направление перемещения фокуса от элемента к элементу в пользовательском интерфейсе приложения.
Возвращаемое значение
значение null , если фокус не может быть задан в указанном направлении.
- Атрибуты
Комментарии
Для программного перемещения фокуса можно также использовать метод FindNextElement(FocusNavigationDirection, FindNextElementOptions) или метод FindNextElement(FocusNavigationDirection). Эти методы извлекают элемент (как DependencyObject), который будет получать фокус на основе указанного направления навигации (только направленная навигация, не может использоваться для эмуляции навигации по вкладкам).
Примечание
Мы рекомендуем использовать метод FindNextElement вместо FindNextFocusableElement, так как FindNextFocusableElement извлекает UIElement, который возвращает значение NULL, если следующий фокусируемый элемент не является UIElement (например, объект Hyperlink ).
См. также раздел
- FindNextFocusableElement(FocusNavigationDirection, Rect)
- Взаимодействие с помощью клавиатуры
- Перемещение фокуса с помощью клавиатуры, геймпада, пульта дистанционного управления и средств специальных возможностей
- Программное перемещение фокуса
Применяется к
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
Направление перемещения фокуса от элемента к элементу в пользовательском интерфейсе приложения.
- hintRect
- Rect
Ограничивающий прямоугольник, используемый для определения того, какой элемент, скорее всего, будет считаться следующим для получения фокуса. Примеры, в которых это может быть полезно:
- Если ни один элемент не имеет фокуса, указание небольшого прямоугольника в расположении экрана (-1, -1) начинает фокус из левого верхнего угла экрана.
- В руководстве по программе, где требуется убедиться, что программы в текущее время получают фокус. (Алгоритм фокусировки может предпочесть отображение позже на основе ряда факторов.)
Возвращаемое значение
значение null , если фокус не может быть задан в указанном направлении.
- Атрибуты
Комментарии
Для программного перемещения фокуса можно также использовать метод FindNextElement(FocusNavigationDirection, FindNextElementOptions) или метод FindNextElement(FocusNavigationDirection). Эти методы извлекают элемент (как DependencyObject), который будет получать фокус на основе указанного направления навигации (только направленная навигация, не может использоваться для эмуляции навигации по вкладкам).
Примечание
Мы рекомендуем использовать метод FindNextElement вместо FindNextFocusableElement, так как FindNextFocusableElement извлекает UIElement, который возвращает значение NULL, если следующий фокусируемый элемент не является UIElement (например, объект Hyperlink ).
См. также раздел
- FindNextFocusableElement(FocusNavigationDirection)
- Взаимодействие с помощью клавиатуры
- Перемещение фокуса с помощью клавиатуры, геймпада, пульта дистанционного управления и средств специальных возможностей
- Программное перемещение фокуса