IUIAnimationStoryboard2::AddTransitionBetweenKeyframes-Methode (uianimation.h)

Artikel
03/03/2024

Fügt einen Übergang zwischen zwei Keyframes hinzu.

Syntax

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable2   *variable,
  [in] IUIAnimationTransition2 *transition,
  [in] UI_ANIMATION_KEYFRAME   startKeyframe,
  [in] UI_ANIMATION_KEYFRAME   endKeyframe
);

Parameter

[in] variable

Die Animationsvariable, für die der Übergang hinzugefügt werden soll.

[in] transition

Der hinzuzufügende Übergang.

[in] startKeyframe

Ein Keyframe, der den Anfang des neuen Übergangs angibt.

[in] endKeyframe

Ein Keyframe, der das Ende des neuen Übergangs angibt. Es darf nicht möglich sein , dass endKeyframe früher im Storyboard als startKeyframe angezeigt wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Rückgabecode	Beschreibung
UI_E_TRANSITION_ALREADY_USED	Dieser Übergang wurde bereits einem Storyboard hinzugefügt oder einem Storyboard hinzugefügt, das die Wiedergabe beendet und veröffentlicht hat.
UI_E_TRANSITION_ECLIPSED	Der Übergang könnte den Anfang eines anderen Übergangs im Storyboard in den Schatten stellen.
UI_E_START_KEYFRAME_AFTER_END	Der Start-Keyframe kann nach dem End-Keyframe auftreten.

Eine Liste der Fehlercodes finden Sie unter Windows-Animationsfehlercodes .

Hinweise

Diese Methode wendet den angegebenen Übergang auf die angegebene Variable im Storyboard an, wobei der Übergang bei den angegebenen Keyframes beginnt und endet. Wenn der Übergang mit einem angegebenen duration-Parameter erstellt wurde, wird diese Dauer mit der Dauer zwischen den Start- und End-Keyframes überschrieben. Andernfalls beschleunigt oder verlangsamt Die Windows-Animation den Übergang nach Bedarf.

Ein Keyframe stellt einen Zeitpunkt innerhalb eines Storyboards dar und kann verwendet werden, um die Anfangs- und Endzeiten von Übergängen anzugeben. Da Keyframes an den Enden von Übergängen hinzugefügt werden können, sind ihre Offsets vom Anfang des Storyboards möglicherweise erst bekannt, wenn das Storyboard wiedergegeben wird.

Übergänge müssen in der Reihenfolge hinzugefügt werden, in der sie wiedergegeben werden. Ein Übergang beginnt möglicherweise abzuspielen, bevor der vorherige Übergang im Storyboard abgeschlossen ist. In diesem Fall werden der Anfangswert und die geschwindigkeit, die vom neuen Übergang gesehen werden, durch den Zustand des vorangehenden Übergangs bestimmt. Es darf nicht möglich sein, dass ein Übergang vor dem Beginn des vorherigen Übergangs beginnt.

Anforderungen

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