IUIAnimationStoryboard::RepeatBetweenKeyframes-Methode (uianimation.h)

Erstellt eine Schleife zwischen zwei angegebenen Keyframes.

Syntax

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME startKeyframe,
  [in] UI_ANIMATION_KEYFRAME endKeyframe,
  [in] INT32                 repetitionCount
);

Parameter

[in] startKeyframe

Der Keyframe, an dem die Schleife beginnen soll.

[in] endKeyframe

Der Keyframe, an dem die Schleife enden soll. Es darf nicht möglich sein , dass endKeyframe früher im Storyboard als startKeyframe auftritt.

[in] repetitionCount

Die Häufigkeit, mit der die Schleife wiederholt werden soll; Dieser Parameter muss 0 oder eine positive Zahl sein. Verwenden Sie UI_ANIMATION_REPEAT_INDEFINITELY (-1), um die Schleife unbegrenzt zu wiederholen, bis das Storyboard gekürzt oder abgeschlossen ist.

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 Windows-Animationsfehlercodes .

Rückgabecode Beschreibung
UI_E_START_KEYFRAME_AFTER_END
Der Start-Keyframe kann nach dem End-Keyframe auftreten.
UI_E_END_KEYFRAME_NOT_DETERMINED
Es ist möglicherweise nicht möglich, den Zeitpunkt des Endschlüsselrahmens zu bestimmen, zu dem der Startschlüsselrahmen erreicht ist.
UI_E_LOOPS_OVERLAP
Zwei wiederholte Teile eines Storyboards können sich überschneiden.

Hinweise

Diese Methode weist ein Storyboard an, das Intervall zwischen den angegebenen Keyframes wiederholt wiederzugeben, bevor der Rest des Storyboards wiedergegeben wird. Wenn eine endliche Wiederholungsanzahl angegeben wird, gibt die Schleife immer diese Anzahl von Wiederholungen wieder. Wenn UI_ANIMATION_REPEAT_INDEFINITELY (-1) angegeben wird, wird die Schleife wiederholt, bis das Storyboard abgeschlossen ist. In diesem Fall wird die aktuelle Iteration der Schleife abgeschlossen, und der Rest des Storyboards wird wiedergegeben. Ein Storyboard, das unbegrenzt schleift, endet auch, wenn es abgeschnitten wird.

Geschachtelte und überlappende Schleifen werden nicht unterstützt.

Ein Keyframe stellt einen Zeitpunkt innerhalb eines Storyboards dar und kann verwendet werden, um die Anfangs- oder 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.

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

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddKeyframeAtOffset