-api-id | -api-type |
---|---|
P:Microsoft.UI.Xaml.Controls.Control.RequiresPointer |
winrt property |
Gets or sets whether a UI element supports mouse mode, which emulates pointer interaction experiences with non-pointer input devices such as a keyboard or game controller.
<control RequiresPointer="requiresPointerMemberName"/>
- requiresPointerMemberName
- requiresPointerMemberNameA named constant of the RequiresPointer enumeration, such as WhenEngaged.
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 or the directional pad (D-pad) and thumb sticks on a game controller. For some user experiences, such as maps and drawing surfaces, it is not possible or practical to use XY focus navigation. RequiresPointer enables an app to provide a more pointer-like interaction experience through a cursor that can be moved freely using the game controller.
RequiresPointer is supported only when using a game controller. The property is ignored otherwise.
For more info, see the Mouse mode section of Designing for Xbox and TV.