FocusState Enum
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Describes how an element obtained focus.
public enum class FocusState/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class FocusState[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum FocusStatePublic Enum FocusState- Inheritance
-
FocusState
- Attributes
| Device family |
Windows 10 (introduced in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v1.0)
|
| Name | Value | Description |
|---|---|---|
| Unfocused | 0 | Element is not currently focused. |
| Pointer | 1 | Element obtained focus through a pointer action. |
| Keyboard | 2 | Element obtained focus through a keyboard action, such as tab sequence traversal. |
| Programmatic | 3 | Element obtained focus through a deliberate call to Focus or a related API. |
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.
| Product | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |