FocusManager 클래스

참조

정의

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

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

애플리케이션의 모든 요소에서 포커스 작업 및 이벤트를 전역으로 관리할 수 있는 도우미 클래스입니다.

public ref class FocusManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FocusManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FocusManager

Public NotInheritable Class FocusManager

상속: Object Platform::Object IInspectable FocusManager

특성: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

예제

TryMoveFocus를 사용하여 화살표 키를 사용하여 UI 요소 사이를 트래버스합니다.

private void Page_KeyUp(object sender, KeyRoutedEventArgs e)
{
   if (e.Key == Windows.System.VirtualKey.Up)
   {
      // Mimic Shift+Tab when user hits up arrow key.
      FocusManager.TryMoveFocus(FocusNavigationDirection.Previous);
   }
   else if (e.Key == Windows.System.VirtualKey.Down)
   {
      // Mimic Tab when user hits down arrow key.
      FocusManager.TryMoveFocus(FocusNavigationDirection.Next);
   }
}

설명

가능하면 FocusManager 이벤트 대신 UIElement 포커스 라우트된 이벤트를 사용하는 것이 좋습니다.

FocusManager는 애플리케이션의 특정 요소가 UIElement에서 버블링된 이벤트를 수신하지 않는 고급 시나리오를 위한 것입니다. 예를 들어 Popup, Tooltip 또는 MenuFlyout과 같은 시각적 개체는 앱 UI의 일부로 표시되지만 실제로는 시각적 트리 계층 구조의 일부가 아닌 scope 자체 포커스입니다. 팝업의 경우 프로그래밍 방식으로 IsOpen을 true로 설정하고 포커스가 팝업의 내/외부로 이동할 때 발생합니다.

예제를 설명하는 몇 가지 기본 태그는 다음과 같습니다.

<Page …>
    <Grid …>
        <Popup …>
            <StackPanel Name="StackPanel3" …>
                <TextBlock Text="StackPanel3" />
                <Button Content="Button5" …/>
            </StackPanel>
        </Popup>
        <TextBlock Text="Grid" … />
        <StackPanel Name="StackPanel1" …>
            <TextBlock Text="StackPanel1" …/>
            <Button Content="Button1" …/>
            <Button Content="Button2" … />
        </StackPanel>
        <StackPanel Name="StackPanel2" …>
            <TextBlock Text="StackPanel2" …/>
            <Button Content="Button3" … />
            <Button Content="Button4" … />
        </StackPanel>
    </Grid>
</Page>

이 경우 Popup에는 StackPanel3이 포함되며, 그러면 Button5가 포함됩니다. IsOpen이 true로 설정되고 포커스가 Button1에서 Button5로 이동하면 LosingFocus 및 LostFocus 이벤트가 시각적 트리에 버블 업됩니다(StackPanel1, Grid 및 Page는 이러한 이벤트를 모두 가져옵니다). 그러나 StackPanel3만 Button5에서 버블 업되는 후속 GettingFocus 및 GotFocus 이벤트를 받습니다(Grid 및 Page는 Popup과 부모-자식 관계에 있지 않으므로 그렇지 않음).

애플리케이션에는 논리적 포커스가 있는 여러 요소가 있을 수 있습니다(포커스 범위 수에 따라 다름). 그러나 애플리케이션의 한 요소만 키보드 포커스를 가질 수 있습니다.

논리적 포커스가 있는 요소가 여러 개 있을 수 있지만 포커스당 논리적 포커스가 있는 요소는 하나만 scope. 논리적 포커스가 있는 요소에 반드시 키보드 포커스가 있는 것은 아니지만 키보드 포커스가 있는 요소에는 논리적 포커스가 있습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	FindFirstFocusableElement
1703	15063	FindLastFocusableElement
1703	15063	FindNextElement(FocusNavigationDirection)
1703	15063	FindNextElement(FocusNavigationDirection,FindNextElementOptions)
1703	15063	TryMoveFocus(FocusNavigationDirection,FindNextElementOptions)
1803	17134	TryFocusAsync
1803	17134	TryMoveFocusAsync(FocusNavigationDirection)
1803	17134	TryMoveFocusAsync(FocusNavigationDirection,FindNextElementOptions)
1809	17763	GettingFocus
1809	17763	GotFocus
1809	17763	LosingFocus
1809	17763	LostFocus
1903	18362	GetFocusedElement(XamlRoot)

메서드

FindFirstFocusableElement(DependencyObject)	지정된 scope 기반으로 포커스를 받을 수 있는 첫 번째 요소를 검색합니다.
FindLastFocusableElement(DependencyObject)	지정된 scope 기반으로 포커스를 받을 수 있는 마지막 요소를 검색합니다.
FindNextElement(FocusNavigationDirection)	지정된 탐색 방향에 따라 포커스를 받아야 하는 요소를 검색합니다.
FindNextElement(FocusNavigationDirection, FindNextElementOptions)	지정된 탐색 방향에 따라 포커스를 받아야 하는 요소를 검색합니다(탭 탐색에는 사용할 수 없습니다. 설명 참조).
FindNextFocusableElement(FocusNavigationDirection)	지정된 탐색 방향에 따라 포커스를 받아야 하는 요소를 검색합니다.
FindNextFocusableElement(FocusNavigationDirection, Rect)	지정된 탐색 방향 및 힌트 사각형에 따라 포커스를 받아야 하는 요소를 검색합니다.
GetFocusedElement()	포커스가 있는 UI의 요소를 검색합니다.
GetFocusedElement(XamlRoot)	Xaml 아일랜드 컨테이너 내에서 포커스가 있는 요소를 검색합니다.
TryFocusAsync(DependencyObject, FocusState)	애플리케이션이 초기화될 때 요소에 포커스를 비동기적으로 설정하려고 시도합니다.
TryMoveFocus(FocusNavigationDirection)	포커스가 있는 요소에서 지정된 방향으로 포커스가 있는 다음 포커스 가능 요소로 포커스를 변경하려고 시도합니다.
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)	지정된 탐색 옵션을 사용하여 포커스가 있는 요소에서 지정된 방향으로 포커스가 있는 다음 포커스 가능 요소로 포커스를 변경하려고 시도합니다.
TryMoveFocusAsync(FocusNavigationDirection)	포커스가 있는 현재 요소에서 지정된 방향으로 포커스가 있는 다음 포커스 가능 요소로 포커스를 변경하려고 비동기적으로 시도합니다.
TryMoveFocusAsync(FocusNavigationDirection, FindNextElementOptions)	포커스가 있는 현재 요소에서 지정된 방향의 다음 포커스 가능 요소로 포커스를 변경하고 지정된 탐색 옵션의 적용을 받도록 비동기적으로 시도합니다.

이벤트

GettingFocus	요소가 실제로 포커스를 받기 전에 발생합니다. 이 이벤트는 이벤트가 버블링되는 동안 포커스가 이동되지 않도록 동기적으로 발생합니다.
GotFocus	컨테이너 요소 내의 요소(포커스 scope)가 포커스를 받을 때 발생합니다. 이 이벤트는 비동기적으로 발생하므로 버블링이 완료되기 전에 포커스가 이동할 수 있습니다.
LosingFocus	포커스가 있는 현재 요소에서 대상 요소로 포커스가 이동하기 전에 발생합니다. 이 이벤트는 이벤트가 버블링되는 동안 포커스가 이동되지 않도록 동기적으로 발생합니다.
LostFocus	컨테이너 요소 내의 요소(포커스 scope)가 포커스를 잃을 때 발생합니다. 이 이벤트는 비동기적으로 발생하므로 버블링이 완료되기 전에 포커스가 다시 이동할 수 있습니다.

적용 대상

FocusManager 클래스

정의

Windows 요구 사항

예제

설명

버전 기록

메서드

이벤트

적용 대상

추가 정보

피드백

피드백

추가 리소스