Windows.UI.Xaml.VisualStateGroup.CurrentState

-description

Gets the most recently set VisualState from a successful call to the GoToState method.

-property-value

The most recently set VisualState from a successful call to the GoToState method, or null.

-remarks

If GoToState has never been called for the states in a particular VisualStateGroup, CurrentState is null. With correct design of controls and visual state, this shouldn't happen. The control logic for a control should always be able to select one state from a given VisualStateGroup, even if that state is a named state with no specific storyboarded behavior.

Because there are potentially multiple VisualStateGroup sets of visual states for a control, each such VisualStateGroup can report a CurrentState. For example, if you click on a Button with a default control template, the "CommonStates" VisualStateGroup reports a CurrentState of "Pressed", and the "FocusStates" VisualStateGroup reports a CurrentState of "PointerFocused".

-examples

-see-also

VisualState, GoToState, CurrentStateChanged, Quickstart: Control templates