FocusState FocusState FocusState Enum


Describes how an element obtained focus.

public enum FocusStatepublic enum FocusStatePublic Enum FocusState
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


FocusState is used as a value by the FocusState property. It's also used as an input by the Focus(FocusState) method.

If used as an input parameter for Focus(FocusState), you can't use Unfocused. Which value of FocusState to pass to a Focus(FocusState) call depends on the input scenario and which user interaction your control or app code is responding to. For more info, see Remarks in Focus(FocusState).

The exact meaning of the FocusState values depends on whether you're reading it from FocusState, or using a value to send to Focus(FocusState). If you are setting Focus(FocusState) you're informing other callers (like the control templates) about how that control obtained focus.


Keyboard Keyboard Keyboard Keyboard

Element obtained focus through a keyboard action, such as tab sequence traversal.

Pointer Pointer Pointer Pointer

Element obtained focus through a pointer action.

Programmatic Programmatic Programmatic Programmatic

Element obtained focus through a deliberate call to Focus(FocusState) or a related API.

Unfocused Unfocused Unfocused Unfocused

Element is not currently focused.