Control.XYFocusUp 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

사용자가 방향 패드(D 패드)를 누를 때 포커스를 받는 개체를 가져오거나 설정합니다.

public:
 property DependencyObject ^ XYFocusUp { DependencyObject ^ get(); void set(DependencyObject ^ value); };

DependencyObject XYFocusUp();

void XYFocusUp(DependencyObject value);

public DependencyObject XYFocusUp { get; set; }

var dependencyObject = control.xYFocusUp;
control.xYFocusUp = dependencyObject;

Public Property XYFocusUp As DependencyObject

<control XYFocusUp="{x:Bind dependencyObjectValue}"/>

속성 값

DependencyObject

사용자가 방향 패드(D 패드)를 누를 때 포커스를 받는 개체입니다.

Windows 요구 사항

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

설명

XYFocusUp은 Xbox 장치 패밀리에서만 지원되며 게임 패드 또는 리모컨을 사용하는 경우에만 지원됩니다. 그렇지 않으면 속성이 무시됩니다.

이 속성에 대한 자세한 내용은 Xbox 및 TV용 디자인 문서의 XY 포커스 탐색 및 상호 작용 섹션을 참조하세요.

버전 호환성

Windows 10 버전 1607 이전에는 XYFocusUp 속성을 사용할 수 없습니다. Microsoft Visual Studio에서 앱의 '최소 플랫폼 버전' 설정이 이 페이지의 뒷부분에 있는 요구 사항 블록에 표시된 '도입된 버전'보다 작은 경우 이를 고려하여 앱을 디자인하고 테스트해야 합니다. 자세한 내용은 버전 적응 코드를 참조하세요.

앱이 이전 버전의 Windows 10 실행되는 경우 예외를 방지하려면 XAML에서 이 속성을 설정하거나 런타임 검사 수행하지 않고 사용하지 마세요. 이 예제에서는 ApiInformation 클래스를 사용하여 설정하기 전에 이 속성이 있는지 검사 방법을 보여줍니다.

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "XYFocusUp"))
{
    button1.XYFocusUp = button2;
}