Storyboard.GetCurrentState Methode

Referenz

Definition

Namespace:: Windows.UI.Xaml.Media.Animation

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft den Uhrzustand des Storyboards ab.

public:
 virtual ClockState GetCurrentState() = GetCurrentState;

ClockState GetCurrentState();

public ClockState GetCurrentState();

function getCurrentState()

Public Function GetCurrentState () As ClockState

Gibt zurück

ClockState

Einer der Enumerationswerte. Kann sein: Aktiv, Füllen oder Beendet.

Hinweise

Diese Methode ist nützlich, wenn Sie die Eigenschaften einer Animation zur Laufzeit ändern möchten, bevor die Animation gestartet wird. Eine Animation, die beendet wird (GetCurrentState gibt ClockState.Stopped zurück) kann weiterhin geändert werden. Eine Animation, die ausgeführt wird (GetCurrentState gibt entweder ClockState.Active oder ClockState.Filling zurück), kann nicht geändert werden, und Sie erhalten eine Fehlermeldung, wenn Sie versuchen.

Hinweise zu früheren Versionen

Windows 8

Eine Animation kann einen optionalen BeginTime-Wert aufweisen, der ändert, wann die Animation tatsächlich beginnt, sich auf Werte zu auswirken, im Vergleich zum Start des steuernden Storyboards. Selbst wenn die Laufzeit beginTime noch nicht erreicht hat, ist es unzulässig, die Eigenschaften der Animation zu ändern, sobald das Storyboard sie startet. Für Windows 8 wird beim Aufrufen von GetCurrentState für eine ausgeführte Animation, bei der die Laufzeit nicht die BeginTime erreicht hat, immer ClockState.Stopped zurückgegeben. Normalerweise ist es zulässig, die Eigenschaften einer Animation zu ändern, aber in diesem speziellen Fall ist dies nicht der Fall. Daher ist die Verwendung von GetCurrentState, um zu bestimmen, ob das Ändern der Animation zulässig ist, nicht immer korrekt. Ab Windows 8.1 gibt der Aufruf von GetCurrentState für eine Animation, die vom Storyboard gestartet wurde, immer ClockState.Active zurück, auch wenn der BeginTime-Wert vorhanden ist und nicht erreicht wurde. Die Umstände, unter denen GetCurrentState ClockState.Filling zurückgibt, bleiben unverändert.

Apps, die für Windows 8 kompiliert wurden, aber unter Windows 8.1 ausgeführt werden, weisen weiterhin das Windows 8-Verhalten auf.

Gilt für:

Share via