FrameworkElement.GoToElementStateCore(String, Boolean) Methode

Definition

Namespace:

Microsoft.UI.Xaml

Wenn sie in einer abgeleiteten Klasse implementiert ist, wird die Erstellung einer visuellen Struktur pro Zustand für eine Steuerelementvorlage im Code aktiviert, anstatt XAML für alle Zustände beim Start des Steuerelements zu laden.

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

Parameter

stateName

String

Platform::String

winrt::hstring

Der Zustand, in den der Übergang durchgeführt wird.

useTransitions

Boolean

bool

true , um eine VisualTransition zu verwenden, um zwischen Zuständen zu wechseln. false , um die Verwendung von Übergängen zu überspringen und direkt zum angeforderten Zustand zu wechseln. Der Standardwert lautet false.

Gibt zurück

Boolean

bool

true , wenn das Steuerelement erfolgreich in den neuen Zustand wechselt oder diesen Zustand bereits verwendet hat; falseandernfalls .

Hinweise

Die Standardimplementierung von FrameworkElement.GoToElementStateCore stellt das normale Zustandsänderungsverhalten bereit, auf das durch Aufrufen von VisualStateManager.GoToState zugegriffen wird, sowie das Standardverhalten der Steuerelementvorlage/des visuellen Zustands für jedes XAML-Steuerelement. Sie sollten nur überschreiben FrameworkElement.GoToElementStateCore , wenn Sie bereit sind, die volle Verantwortung für das Erstellen der visuellen Struktur für ein Steuerelement in Ihrem Code zur Laufzeit zu übernehmen. Dies umfasst die Darstellung von Inhalten, die aus Inhaltseigenschaften, untergeordneten Elementsammlungen usw. stammen.

Für allgemeine Zustandsänderungslogik in einem benutzerdefinierten Steuerelement sollten Sie VisualStateManager.GoToState verwenden. Das vorgesehene Szenario für FrameworkElement.GoToElementStateCore ist eingeschränkter, es ist speziell für Apps oder Steuerelemente vorgesehen, die die Vorlage oder Logik optimieren möchten, die die visuelle Struktur eines ListViewItem - oder GridViewItem-Objekts erstellt und den Inhalt darstellt.

VisualStateManager.GoToState weist eine etwas andere Signatur auf, da es sich um eine statische Hilfsprogramm-API handelt und einen Steuerelementparameter verwendet, um anzugeben, auf welches Steuerelement Zustandsänderungen angewendet werden sollen. FrameworkElement.GoToElementStateCore verwendet das aufrufende Objekt, um diese Informationen abzurufen.

Weitere Informationen

• GoToState(Control, String, Boolean)