Application.RequiresPointerMode Property
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets whether a UWP app supports mouse mode, which emulates pointer interaction experiences with non-pointer input devices such as an game pad or remote control. (All nested elements inherit this behavior.)
public:
property ApplicationRequiresPointerMode RequiresPointerMode { ApplicationRequiresPointerMode get(); void set(ApplicationRequiresPointerMode value); };ApplicationRequiresPointerMode RequiresPointerMode();
void RequiresPointerMode(ApplicationRequiresPointerMode value);public ApplicationRequiresPointerMode RequiresPointerMode { get; set; }var applicationRequiresPointerMode = application.requiresPointerMode;
application.requiresPointerMode = applicationRequiresPointerMode;Public Property RequiresPointerMode As ApplicationRequiresPointerModeThe pointer emulation mode. The default is Auto (the default system experience for the input device).
| Device family |
Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v3.0)
|
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 a 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 game 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.
| Product | Versions |
|---|---|
| WinRT | Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |