FrameworkElement.GoToElementStateCore(String, Boolean) Method
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.
When implemented in a derived class, enables per-state construction of a visual tree for a control template in code, rather than by loading XAML for all states at control startup.
protected:
virtual bool GoToElementStateCore(Platform::String ^ stateName, bool useTransitions) = GoToElementStateCore;bool GoToElementStateCore(winrt::hstring const& stateName, bool const& useTransitions);protected virtual bool GoToElementStateCore(string stateName, bool useTransitions);function goToElementStateCore(stateName, useTransitions)Protected Overridable Function GoToElementStateCore (stateName As String, useTransitions As Boolean) As Boolean- stateName
-
String
Platform::String
winrt::hstring
The state to transition to.
- useTransitions
-
Boolean
bool
true to use a VisualTransition to transition between states. false to skip using transitions and go directly to the requested state. The default is false.
bool
true if the control successfully transitions to the new state, or was already using that state; otherwise, false.
The default implementation of FrameworkElement.GoToElementStateCore provides the normal state change behavior that's accessed by calling VisualStateManager.GoToState, and also the default control template / visual state loading behavior for any XAML control. You should only override FrameworkElement.GoToElementStateCore if you are prepared to take full responsibility for constructing the visual tree for a control in your code at run time. This includes presentation of any content that comes from content properties, child element collections, and so on.
For general state change logic in a custom control, you should use VisualStateManager.GoToState. The intended scenario for FrameworkElement.GoToElementStateCore is more limited, it's specifically intended for apps or controls that want to optimize the template or logic that creates the visual tree of a ListViewItem or a GridViewItem and presents the contents.
VisualStateManager.GoToState has a slightly different signature because it's a static utility API and uses a control parameter to specify what control to apply state changes to. FrameworkElement.GoToElementStateCore uses the calling object to get this information.
| 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 |