FrameworkElement.GoToElementStateCore(String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При реализации в производном классе включает создание визуального дерева для каждого состояния для шаблона элемента управления в коде, а не путем загрузки XAML для всех состояний при запуске элемента управления.
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
Состояние, в которое требуется перейти.
- useTransitions
-
Boolean
bool
true
, чтобы использовать VisualTransition для перехода между состояниями.
false
, чтобы пропустить переходы и перейти непосредственно в запрошенное состояние. Значение по умолчанию — false
.
Возвращаемое значение
bool
true
значение , если элемент управления успешно переходит в новое состояние или уже использует это состояние; в противном случае — false
.
Комментарии
Реализация FrameworkElement.GoToElementStateCore
по умолчанию обеспечивает нормальное поведение изменения состояния, доступ к которому можно получить путем вызова VisualStateManager.GoToState, а также поведение загрузки шаблона элемента управления или визуального состояния по умолчанию для любого элемента управления XAML. Переопределять FrameworkElement.GoToElementStateCore
следует только в том случае, если вы готовы взять на себя полную ответственность за создание визуального дерева для элемента управления в коде во время выполнения. Сюда входит представление любого содержимого, полученного из свойств содержимого, коллекций дочерних элементов и т. д.
Для общей логики изменения состояния в пользовательском элементе управления следует использовать VisualStateManager.GoToState. Предполагаемый сценарий для FrameworkElement.GoToElementStateCore
является более ограниченным, он предназначен специально для приложений или элементов управления, которые хотят оптимизировать шаблон или логику, которые создают визуальное дерево ListViewItem или GridViewItem и представляют содержимое.
VisualStateManager.GoToState имеет немного другую сигнатуру, так как это api статической служебной программы и использует параметр элемента управления , чтобы указать, к какому элементу управления следует применить изменения состояния.
FrameworkElement.GoToElementStateCore
использует вызывающий объект для получения этих сведений.