IUIAnimationStoryboard::AddTransitionBetweenKeyframes-Methode (uianimation.h)

Artikel
08/26/2023

Fügt einen Übergang zwischen zwei Keyframes hinzu.

Syntax

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *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 Beginn 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 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 .

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 Beginn eines anderen Übergangs im Storyboard in den Schatten stellen.
UI_E_START_KEYFRAME_AFTER_END	Der Startschlüsselrahmen kann nach dem Endschlüsselframe auftreten.

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 Dauerparameter erstellt wurde, wird diese Dauer mit der Dauer zwischen den Start- und Endschlüsselframes überschrieben. Andernfalls beschleunigt oder verlangsamt Windows-Animation den Übergang nach Bedarf.

Ein Keyframe stellt einen Moment in einem Storyboard dar und kann verwendet werden, um die Anfangs- und Endzeit 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 kann mit der Wiedergabe beginnen, 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 vorherigen festgelegt. Es darf nicht möglich sein, dass ein Übergang vor dem Beginn des vorherigen Übergangs beginnt.

Anforderungen


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