FrameworkElement.GoToElementStateCore(String, Boolean) Méthode

Définition

En cas d’implémentation dans une classe dérivée, active la construction par état d’une arborescence visuelle pour un modèle de contrôle dans le code, plutôt qu’en chargeant XAML pour tous les états au démarrage du contrôle.

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

Paramètres

stateName
String

Platform::String

winrt::hstring

État vers lequel effectuer la transition.

useTransitions
Boolean

bool

true pour utiliser un VisualTransition pour passer d’un état à l’autre. false pour ignorer l’utilisation des transitions et accéder directement à l’état demandé. La valeur par défaut est false.

Retours

Boolean

bool

true si le contrôle passe correctement au nouvel état ou s’il utilise déjà cet état ; sinon, false.

Remarques

L’implémentation par défaut de FrameworkElement.GoToElementStateCore fournit le comportement normal de changement d’état accessible en appelant VisualStateManager.GoToState, ainsi que le modèle de contrôle par défaut/le comportement de chargement de l’état visuel pour tout contrôle XAML. Vous ne devez remplacer FrameworkElement.GoToElementStateCore que si vous êtes prêt à assumer l’entière responsabilité de la construction de l’arborescence visuelle pour un contrôle dans votre code au moment de l’exécution. Cela inclut la présentation de tout contenu provenant de propriétés de contenu, de collections d’éléments enfants, etc.

Pour la logique de changement d’état général dans un contrôle personnalisé, vous devez utiliser VisualStateManager.GoToState. Le scénario prévu pour FrameworkElement.GoToElementStateCore est plus limité, il est spécifiquement destiné aux applications ou aux contrôles qui souhaitent optimiser le modèle ou la logique qui crée l’arborescence visuelle d’un ListViewItem ou d’un GridViewItem et présente le contenu.

VisualStateManager.GoToState a une signature légèrement différente, car il s’agit d’une API d’utilitaire statique et utilise un paramètre de contrôle pour spécifier le contrôle auquel appliquer les modifications d’état. FrameworkElement.GoToElementStateCore utilise l’objet appelant pour obtenir ces informations.

S’applique à

Voir aussi