Control.IsFocusEngaged Property

Definition

Get or sets a value that indicates whether focus is constrained to the control when the user presses the A/Select button on a game controller.

C#
public bool IsFocusEngaged { get; set; }
XAML
<control IsFocusEngaged="bool"/>

Property Value

Boolean

true if focus is constrained within the control boundaries; otherwise, false.

Remarks

IsFocusEngagementEnabled must be true and the control must have focus before you set the IsFocusEngaged property to true. Otherwise, a runtime exception will occur.

When the IsFocusEngagementEnabled property is set to true, it marks the control as requiring focus engagement. This means that the user must press the A/Select button to "engage" the control and interact with it. When they are finished, they can press the B/Back button to disengage the control and navigate away from it.

Focus engagement makes it easier to use a game controller to interact with an app. Setting focus engagement does not affect keyboard or other input devices. For more info, see Focus engagement.

Applies to

Proizvod Verzije
Windows App SDK 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6

See also