Control.RequiresPointer Property

Definition

Namespace:

Microsoft.UI.Xaml.Controls

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.

public:
 property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };

RequiresPointer RequiresPointer();

void RequiresPointer(RequiresPointer value);

public RequiresPointer RequiresPointer { get; set; }

var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;

Public Property RequiresPointer As RequiresPointer

<control RequiresPointer="requiresPointerMemberName"/>

Property Value

RequiresPointer

The pointer emulation mode. The default is Never.

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 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.