IUIAnimationInterpolator::GetDependencies-Methode (uianimation.h)

Artikel
08/26/2023

Ruft die Aspekte des Interpolators ab, die von dem an SetInitialValueAndVelocity übergebenen Anfangswert oder der Geschwindigkeit abhängen oder von der an SetDuration übergebenen Dauer abhängen.

Syntax

HRESULT GetDependencies(
  [out] UI_ANIMATION_DEPENDENCIES *initialValueDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *initialVelocityDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *durationDependencies
);

Parameter

[out] initialValueDependencies

Aspekte des Interpolators, die vom an SetInitialValueAndVelocity übergebenen Anfangswert abhängen.

[out] initialVelocityDependencies

Aspekte des Interpolators, die von der anfänglichen Geschwindigkeit abhängen, die an SetInitialValueAndVelocity übergeben wurde.

[out] durationDependencies

Aspekte des Interpolators, die von der an SetDuration übergebenen Dauer abhängen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter Fehlercodes für die Windows-Animation .

Hinweise

Diese Methode wird aufgerufen, um zu identifizieren, welche Aspekte des benutzerdefinierten Interpolators von bestimmten Eingaben beeinflusst werden: Wert, Geschwindigkeit und Dauer. Für jeden dieser Eingaben gibt der Interpolator eine der folgenden Werte zurück:

Das bitweise OR aller elemente von UI_ANIMATION_DEPENDENCIES , die angewendet werden.
UI_ANIMATION_DEPENDENCY_NONE , wenn nichts von der Eingabe abhängt.

Betrachten Sie beispielsweise einen Interpolator (1), der einen endgültigen Wert als Parameter akzeptiert, (2), der bei diesem endenden Wert immer schrittweise beendet wird, und (3), dessen Dauer durch die Differenz zwischen dem End- und dem Anfangswert bestimmt wird. Der Interpolator sollte UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATION für initialValueDependencies zurückgeben. Es sollte nicht UI_ANIMATION_DEPENDENCY_FINAL_VALUE zurückgegeben werden , da dies festgelegt wird, wenn der Interpolator erstellt wird und nicht vom Anfangswert betroffen ist. Ebenso sollte es nicht UI_ANIMATION_DEPENDENCY_FINAL_VELOCITY zurückgeben, da die Steigung der Kurve definiert ist, um immer 0 zu sein, wenn sie den enden Wert erreicht.

Es ist wichtig, dass ein Interpolator die richtigen Flags zurückgibt. Wenn für eine Ausgabe kein Flag vorhanden ist, geht Windows Animation davon aus, dass sich der entsprechende Parameter nicht auf diesen Aspekt der Ergebnisse des Interpolators auswirkt. Wenn der benutzerdefinierte Interpolator beispielsweise UI_ANIMATION_DEPENDENCY_FINAL_VALUE für initialVelocityDependencies nicht enthält, kann Windows-Animation SetInitialValueAndVelocity mit einem beliebigen Geschwindigkeitsparameter aufrufen, und rufen Sie getFinalValue auf, um den endgültigen Wert zu bestimmen. Die Implementierung von GetFinalValue durch den Interpolator muss dasselbe Ergebnis zurückgeben, unabhängig davon, welcher Geschwindigkeitsparameter an SetInitialValueAndVelocity übergeben wurde, da der Interpolator behauptet hat, dass der endgültige Wert des Übergangs nicht von der anfänglichen Geschwindigkeit abhängt.

Hinweis Wenn die für die Dauer zurückgegebenen FlagsAbhängigkeiten keine UI_ANIMATION_DEPENDENCY_DURATION enthalten, wird SetDuration nie für den Interpolator aufgerufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista und Platform Update für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	uianimation.h
DLL	UIAnimation.dll

Weitere Informationen

IUIAnimationInterpolator

UI_ANIMATION_DEPENDENCIES

Freigeben über