Sdílet prostřednictvím


Control.XYFocusUp Property

Definition

Gets or sets the object that gets focus when a user presses the Directional Pad (D-pad) up.

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}"/>

Property Value

The object that gets focus when a user presses the Directional Pad (D-pad) up.

Windows requirements

Device family
Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v3.0)

Remarks

XYFocusUp is supported only on the Xbox device family, and only when using a game pad or remote control. The property is ignored otherwise.

For more info about this property, see the XY focus navigation and interaction section of the Designing for Xbox and TV article.

Version compatibility

The XYFocusUp property is not available prior to Windows 10, version 1607. If your app’s 'minimum platform version' setting in Microsoft Visual Studio is less than the 'introduced version' shown in the Requirements block later in this page, you must design and test your app to account for this. For more info, see Version adaptive code.

To avoid exceptions when your app runs on previous versions of Windows 10, do not set this property in XAML or use it without performing a runtime check. This example shows how to use the ApiInformation class to check for the presence of this property before you set it.

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

Applies to