FocusManager.TryMoveFocus 메서드

  • 참조

정의

네임스페이스:
Windows.UI.Xaml.Input

오버로드

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입니다.

특성
OverloadAttribute

설명

탭 순서는 사용자가 Tab 키(앞으로) 또는 Shift+Tab(뒤로)을 눌러 한 컨트롤에서 다른 컨트롤로 이동하는 순서입니다.

이 메서드는 탭 순서 순서 및 동작을 사용하여 UI의 모든 포커스 가능한 요소를 트래버스합니다.

포커스가 탭 순서의 첫 번째 요소에 있고 FocusNavigationDirection.Previous 가 지정된 경우 포커스가 마지막 요소로 이동합니다.

포커스가 탭 순서의 마지막 요소에 있고 FocusNavigationDirection.Next 가 지정되면 포커스가 첫 번째 요소로 이동합니다.

FindNextElement(FocusNavigationDirection, FindNextElementOptions) 메서드 또는 FindNextElement(FocusNavigationDirection) 메서드를 사용하여 프로그래밍 방식으로 포커스를 이동할 수도 있습니다. 이러한 메서드는 지정된 탐색 방향에 따라 포커스를 받을 요소( DependencyObject)를 검색합니다(방향 탐색만, 탭 탐색을 에뮬레이트하는 데 사용할 수 없음).

참고

FindNextFocusableElement는 다음 포커스 가능 요소가 UIElement(예: Hyperlink 개체)가 아닌 경우 null을 반환하는 UIElement를 검색하므로 FindNextFocusableElement 대신 FindNextElement 메서드를 사용하는 것이 좋습니다.

추가 정보

적용 대상

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

Windows 요구 사항

디바이스 패밀리
Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

설명

탭 순서는 사용자가 Tab 키(앞으로) 또는 Shift+Tab(뒤로)을 눌러 한 컨트롤에서 다른 컨트롤로 이동하는 순서입니다.

이 메서드는 탭 순서 순서 및 동작을 사용하여 UI의 모든 포커스 가능한 요소를 트래버스합니다.

포커스가 탭 순서의 첫 번째 요소에 있고 FocusNavigationDirection.Previous 가 지정된 경우 포커스가 마지막 요소로 이동합니다.

포커스가 탭 순서의 마지막 요소에 있고 FocusNavigationDirection.Next 가 지정되면 포커스가 첫 번째 요소로 이동합니다.

FindNextElement(FocusNavigationDirection, FindNextElementOptions) 메서드 또는 FindNextElement(FocusNavigationDirection) 메서드를 사용하여 프로그래밍 방식으로 포커스를 이동할 수도 있습니다. 이러한 메서드는 지정된 탐색 방향에 따라 포커스를 받을 요소( DependencyObject)를 검색합니다(방향 탐색만, 탭 탐색을 에뮬레이트하는 데 사용할 수 없음).

참고

FindNextFocusableElement는 다음 포커스 가능 요소가 UIElement(예: Hyperlink 개체)가 아닌 경우 null을 반환하는 UIElement를 검색하므로 FindNextFocusableElement 대신 FindNextElement 메서드를 사용하는 것이 좋습니다.

추가 정보

적용 대상