FocusState FocusState FocusState FocusState Enum


Describes how an element obtained focus.

public : enum class FocusState
enum class winrt::Windows::UI::Xaml::FocusState : int32_t
public enum FocusState
Public Enum FocusState

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


Keyboard Keyboard Keyboard Keyboard 2

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

Pointer Pointer Pointer Pointer 1

Element obtained focus through a pointer action.

Programmatic Programmatic Programmatic Programmatic 3

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

Unfocused Unfocused Unfocused Unfocused 0

Element is not currently focused.


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

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

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

See also