Application.RequiresPointerMode Application.RequiresPointerMode Application.RequiresPointerMode Application.RequiresPointerMode Property

Definition

Gets or sets whether a UWP app supports mouse mode, which emulates pointer interaction experiences with non-pointer input devices such as an Xbox gamepad or remote control. (All nested elements inherit this behavior.)

public : ApplicationRequiresPointerMode RequiresPointerMode { get; set; }
ApplicationRequiresPointerMode RequiresPointerMode();

void RequiresPointerMode(ApplicationRequiresPointerMode requirespointermode);
public ApplicationRequiresPointerMode RequiresPointerMode { get; set; }
Public ReadWrite Property RequiresPointerMode As ApplicationRequiresPointerMode

Property Value

The pointer emulation mode. The default is Auto (the default system experience for the input device).

Additional features and requirements

Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

For non-pointer input devices, focus is moved between controls through a variety of methods, such as the Tab and arrow keys on a keyboard, the directional pad (D-pad) on a remote, or thumb sticks on an Xbox controller. For some user experiences, such as maps and drawing surfaces, it is not possible or practical to use XY focus navigation. RequiresPointerMode enables an app to provide a more pointer-like interaction experience through a cursor that can be moved freely using the Xbox input devices.

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

RequiresPointer sets mouse mode at the UI element level.

For more info, see the Mouse mode section of Designing for Xbox and TV.

See Also