VisualStateManager.GoToStateCore Метод

Определение

Пространство имен:

Windows.UI.Xaml

При переопределении в производном классе перемещает элемент управления между состояниями.

protected:
 virtual bool GoToStateCore(Control ^ control, FrameworkElement ^ templateRoot, Platform::String ^ stateName, VisualStateGroup ^ group, VisualState ^ state, bool useTransitions) = GoToStateCore;

bool GoToStateCore(Control const& control, FrameworkElement const& templateRoot, winrt::hstring const& stateName, VisualStateGroup const& group, VisualState const& state, bool const& useTransitions);

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

function goToStateCore(control, templateRoot, stateName, group, state, useTransitions)

Protected Overridable Function GoToStateCore (control As Control, templateRoot As FrameworkElement, stateName As String, group As VisualStateGroup, state As VisualState, useTransitions As Boolean) As Boolean

Параметры

control

Control

Элемент управления, переводимый из одного состояния в другое.

templateRoot

FrameworkElement

Корневой элемент controlTemplate элемента управления.

stateName

String

Platform::String

winrt::hstring

Имя состояния, в которое требуется перейти.

group

VisualStateGroup

Объект VisualStateGroup, к которому принадлежит состояние.

state

VisualState

Представление состояния, в которое требуется перейти.

useTransitions

Boolean

bool

значение true , чтобы использовать VisualTransition для перехода между состояниями; в противном случае — false.

Возвращаемое значение

Boolean

bool

значение true , если элемент управления успешно переходит в новое состояние; в противном случае — false.

Комментарии

Этот API является частью сценария определения пользовательского поведения VisualStateManager . Переопределение GoToStateCore изменяет поведение состояния в поведении пользовательского класса.

Чтобы сослаться на пользовательский класс VisualStateManager , задайте значение присоединенного свойства VisualStateManager.CustomVisualStateManager в любом шаблоне элемента управления, где требуется использовать поведение настраиваемого класса VisualStateManager . Как правило, экземпляр пользовательского класса VisualStateManager создается с помощью конструкции XAML по умолчанию в Application.Resources. Затем присоединенное свойство VisualStateManager.CustomVisualStateManager задается с помощью ссылки расширения разметки {StaticResource} на ключ настраиваемого ресурса VisualStateManager .

Примечания к наследутелям

Когда потребитель пользовательского класса VisualStateManager вызывает GoToState для изменения визуального состояния элемента управления, это поведение по умолчанию, которое вы переопределяете:+ Если VisualState , именованный по имени состояния , имеет раскадровка, раскадровка начинается.

• Если visualState , который использовался элементом управления до нового запрошенного состояния, имеет раскадровка, эта раскадровка останавливается. Если VisualState для stateName не существует в группе, реализация должна возвращать значение false.

Если элемент управления уже находится в запросе VisualState в качестве stateName, реализация должна возвращать значение true.

Дополнительные сведения о поведении по умолчанию см. в разделе GoToState.

События изменения визуального состояния

CurrentStateChanging срабатывает, когда элемент управления начинает переходить состояния в соответствии с запросом вызова GoToState . Если к изменению состояния применяется visualTransition , это событие возникает при начале перехода.

CurrentStateChanged срабатывает после того, как элемент управления находится в состоянии, запрошенном вызовом GoToState , так же, как начинается новая раскадровка . При завершении новой раскадровки событие не запускается.

Если VisualTransition не применяется, CurrentStateChanging и CurrentStateChanged запускаются быстро, но гарантируются в этом порядке, если они происходят.

Однако если переход на изменение состояния прерывается новым вызовом GoToState , событие CurrentStateChanged никогда не вызывается для первого перехода состояния. Для следующего запрошенного изменения состояния запускается новый ряд событий.

Переопределение поведения RaiseCurrentStateChanged и RaiseCurrentStateChanging является необязательным: то, как и когда события вызываются реализацией по умолчанию, может быть достаточно для пользовательского класса.

См. также раздел

• GoToState(Control, String, Boolean)
• Краткое руководство: шаблоны элементов управления