VisualStateManager::RaiseCurrentStateChanging Method (VisualStateGroup^, VisualState^, VisualState^, FrameworkElement^, FrameworkElement^)

.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.

Raises the CurrentStateChanging event on the specified VisualStateGroup object.

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

protected:
void RaiseCurrentStateChanging(
	VisualStateGroup^ stateGroup,
	VisualState^ oldState,
	VisualState^ newState,
	FrameworkElement^ control,
	FrameworkElement^ stateGroupsRoot
)

Parameters

stateGroup
Type: System.Windows::VisualStateGroup^

The object that the CurrentStateChanging event occurred on.

oldState
Type: System.Windows::VisualState^

The state that the control is transitioning from.

newState
Type: System.Windows::VisualState^

The state that the control is transitioning to.

control
Type: System.Windows::FrameworkElement^

The control that is transitioning states.

stateGroupsRoot
Type: System.Windows::FrameworkElement^

The root element that contains the VisualStateManager.

Exception Condition
ArgumentNullException

stateGroupsRoot is null.

-or-

newState is null.

When the VisualStateGroup is set on the ControlTemplate of a control, the control parameter is set to the control that owns ControlTemplate. When the VisualStateGroup is set on a FrameworkElement, control is null and you should use the stateGroupsRoot parameter.

Notes to Inheritors:

When overriding RaiseCurrentStateChanging in a derived class, be sure to call the base class’s RaiseCurrentStateChanging method so that registered delegates receive the event.

.NET Framework
Available since 4.0
Return to top
Show: