FrameworkElement.GoToElementStateCore(String, Boolean) Methode

Definition

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 zum Übergang zwischen Zuständen zu verwenden. false , um die Verwendung von Übergängen zu überspringen und direkt in den angeforderten Zustand zu wechseln. Der Standardwert ist FALSE.

Gibt zurück

Boolean

bool

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

Hinweise

Die Standardimplementierung von FrameworkElement.GoToElementStateCore bietet das normale Zustandsänderungsverhalten, auf das durch Aufrufen von VisualStateManager.GoToState zugegriffen wird, sowie das Standardverhalten der Steuerelementvorlage/des visuellen Zustands für jedes XAML-Steuerelement. Sie sollten FrameworkElement.GoToElementStateCore nur überschreiben, 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 beabsichtigte 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.

Gilt für:

Weitere Informationen