FrameworkElement.GoToElementStateCore(String, Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 BooleanParamè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
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.