FocusManager.TryMoveFocus 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| 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(뒤로)을 눌러 한 컨트롤에서 다른 컨트롤로 이동하는 순서입니다.
이 메서드는 탭 순서 순서 및 동작을 사용하여 UI의 모든 포커스 가능한 요소를 트래버스합니다.
포커스가 탭 순서의 첫 번째 요소에 있고 FocusNavigationDirection.Previous 가 지정된 경우 포커스가 마지막 요소로 이동합니다.
포커스가 탭 순서의 마지막 요소에 있고 FocusNavigationDirection.Next 가 지정되면 포커스가 첫 번째 요소로 이동합니다.
FindNextElement(FocusNavigationDirection, FindNextElementOptions) 메서드 또는 FindNextElement(FocusNavigationDirection) 메서드를 사용하여 프로그래밍 방식으로 포커스를 이동할 수도 있습니다. 이러한 메서드는 지정된 탐색 방향에 따라 포커스를 받을 요소( DependencyObject)를 검색합니다(방향 탐색만, 탭 탐색을 에뮬레이트하는 데 사용할 수 없음).
참고
FindNextFocusableElement는 다음 포커스 가능 요소가 UIElement(예: Hyperlink 개체)가 아닌 경우 null을 반환하는 UIElement를 검색하므로 FindNextFocusableElement 대신 FindNextElement 메서드를 사용하는 것이 좋습니다.
추가 정보
- 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(뒤로)을 눌러 한 컨트롤에서 다른 컨트롤로 이동하는 순서입니다.
이 메서드는 탭 순서 순서 및 동작을 사용하여 UI의 모든 포커스 가능한 요소를 트래버스합니다.
포커스가 탭 순서의 첫 번째 요소에 있고 FocusNavigationDirection.Previous 가 지정된 경우 포커스가 마지막 요소로 이동합니다.
포커스가 탭 순서의 마지막 요소에 있고 FocusNavigationDirection.Next 가 지정되면 포커스가 첫 번째 요소로 이동합니다.
FindNextElement(FocusNavigationDirection, FindNextElementOptions) 메서드 또는 FindNextElement(FocusNavigationDirection) 메서드를 사용하여 프로그래밍 방식으로 포커스를 이동할 수도 있습니다. 이러한 메서드는 지정된 탐색 방향에 따라 포커스를 받을 요소( DependencyObject)를 검색합니다(방향 탐색만, 탭 탐색을 에뮬레이트하는 데 사용할 수 없음).
참고
FindNextFocusableElement는 다음 포커스 가능 요소가 UIElement(예: Hyperlink 개체)가 아닌 경우 null을 반환하는 UIElement를 검색하므로 FindNextFocusableElement 대신 FindNextElement 메서드를 사용하는 것이 좋습니다.