IUIAnimationInterpolator2::SetDuration-Methode (uianimation.h)

Legt die Dauer des Übergangs in der angegebenen Dimension fest.

Syntax

HRESULT SetDuration(
  [in, out] UI_ANIMATION_SECONDS duration
);

Parameter

[in, out] duration

Die Dauer des Übergangs.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein HRESULT-Fehlercode . Eine Liste der Fehlercodes finden Sie unter Windows-Animationsfehlercodes .

Hinweise

Windows-Animation ruft diese Methode nur nach dem Aufrufen der IUIAnimationInterpolator2::GetDependencies-Methode auf, und nur, wenn dieser Aufruf UI_ANIMATION_DEPENDENCY_DURATION als eines seiner durationDependencies-Flags zurückgibt.

In der Regel verfügt ein Interpolator mit einer Dauerabhängigkeit über einen duration-Parameter in der Erstellungsmethode IUIAnimationTransitionFactory oder IUIAnimationTransitionFactory2 , die diesem Interpolator zugeordnet ist. Der Interpolator sollte seine Dauer bei der ersten Initialisierung speichern und die Dauer des Aufrufs von SetDuration überschreiben.

Windows-Animation ruft immer die IUIAnimationInterpolator2::SetInitialValueAndVelocity-Methode auf, um den Anfangswert und die Geschwindigkeit vor dem Aufruf von SetDuration festzulegen, sodass ein benutzerdefinierter Interpolator nicht überprüfen muss, ob der Anfangswert und die Geschwindigkeit festgelegt wurden.

Die Windows-Animation kann SetInitialValueAndVelocity und SetDuration mehrmals mit unterschiedlichen Parametern aufrufen. Interpolatoren können den internen Zustand zwischenspeichern, um die Leistung zu verbessern, aber sie müssen diesen zwischengespeicherten Zustand jedes Mal aktualisieren , wenn SetInitialValueAndVelocity aufgerufen wird, und sicherstellen, dass die Ergebnisse der nachfolgenden Aufrufe von SetDuration den aktualisierten Zustand widerspiegeln.

Anforderungen

Weitere Informationen

IUIAnimationInterpolator2

UI_ANIMATION_DEPENDENCIES

UI_ANIMATION_SECONDS