Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

VisualStateManager.GoToStateCore Method (FrameworkElement, FrameworkElement, String, VisualStateGroup, VisualState, Boolean)

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Transitions a control between states.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

protected virtual bool GoToStateCore(
	FrameworkElement control,
	FrameworkElement stateGroupsRoot,
	string stateName,
	VisualStateGroup group,
	VisualState state,
	bool useTransitions
)

Parameters

control
Type: System.Windows.FrameworkElement

The control to transition between states.

stateGroupsRoot
Type: System.Windows.FrameworkElement

The root element that contains the VisualStateManager.

stateName
Type: System.String

The name of the state to transition to.

group
Type: System.Windows.VisualStateGroup

The VisualStateGroup that the state belongs to.

state
Type: System.Windows.VisualState

The representation of the state to transition to.

useTransitions
Type: System.Boolean

true to use a VisualTransition object to transition between states; otherwise, false.

Return Value

Type: System.Boolean

true if the control successfully transitioned to the new state; otherwise, false.

The GoToStateCore method performs the logic necessary to appropriately start and stop the storyboards that are associated with a transition. When a control calls GoToState to change its state, the VisualStateManager does the following:

  • First, if the VisualState that the control is transitioning to has a Storyboard, the storyboard begins. Then, if the VisualState that the control is coming from has a Storyboard, the storyboard ends.

  • If the control is already in the stateName state, GoToState takes no action and returns true.

  • If stateName does not exist in the ControlTemplate of control, GoToState takes no action and returns false.

You can implement your own VisualStateManager to provide different logic for transitioning between states. For example, you can change the logic described previously, or you can provide logic to transition between custom animation types. To implement a VisualStateManager, create a class that inherits from VisualStateManager and override the GoToStateCore method. To use the custom class, set the CustomVisualStateManager property to an object of your custom type.

.NET Framework
Available since 4.0
Return to top
Show:
© 2018 Microsoft