IUIAnimationStoryboard2::RepeatBetweenKeyframes-Methode (uianimation.h)
Erstellt eine Schleife zwischen zwei Keyframes.
Syntax
HRESULT RepeatBetweenKeyframes(
[in] UI_ANIMATION_KEYFRAME startKeyframe,
[in] UI_ANIMATION_KEYFRAME endKeyframe,
[in] DOUBLE cRepetition,
[in] UI_ANIMATION_REPEAT_MODE repeatMode,
[in] IUIAnimationLoopIterationChangeHandler2 *pIterationChangeHandler,
[in] UINT_PTR id,
[in] BOOL fRegisterForNextAnimationEvent
);
Parameter
[in] startKeyframe
Der Keyframe, an dem die Schleife beginnen soll.
[in] endKeyframe
Der Keyframe, an dem die Schleife enden soll. endKeyframe darf nicht früher im Storyboard als startKeyframe auftreten.
[in] cRepetition
Die Anzahl der Wiederholungen der Schleife; die letzte Iteration einer Schleife kann bruchweise zwischen Keyframes beendet werden. Der Wert null gibt an, dass der angegebene Teil eines Storyboards nicht wiedergegeben wird. Der Wert UI_ANIMATION_REPEAT_INDEFINITELY (-1) gibt an, dass die Schleife unbegrenzt wiederholt wird, bis das Storyboard gekürzt oder abgeschlossen ist.
[in] repeatMode
Das Muster für die Schleifeniteration.
Der Wert UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) gibt an, dass der Start der Schleife zwischen Keyframes (k1-k2>, k2-k1>, k1-k2> usw.) wechseln muss.
Der Wert UI_ANIMATION_REPEAT_MODE_NORMAL (0) gibt an, dass der Start der Schleife mit dem ersten Keyframe (k1-k2>, k1-k2>, k1-k2> usw.) beginnen muss.
[in] pIterationChangeHandler
Der Handler für jedes Schleifeniterationsereignis. Der Standardwert ist 0.
[in] id
Die Schleifen-ID, die an pIterationChangeHandler übergeben werden soll. Der Standardwert ist 0.
[in] fRegisterForNextAnimationEvent
Wenn true, gibt an, dass pIterationChangeHandler in die Schätzung des Zeitintervalls bis zum nächsten Animationsereignis integriert wird, das von der IUIAnimationManager2::EstimateNextEventTime-Methode zurückgegeben wird. Der Standardwert ist 0 oder false.
Rückgabewert
Wenn diese 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 weist ein Storyboard an, das Intervall zwischen den angegebenen Keyframes wiederholt abzuspielen, 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 ist, wiederholt sich die Schleife, 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 Moment in einem Storyboard 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 8, Windows 7 und Platform Update für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | uianimation.h |
| DLL | UIAnimation.dll |