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 |
|---|---|
|
Der Start-Keyframe kann nach dem End-Keyframe auftreten. |
|
Es ist möglicherweise nicht möglich, den Zeitpunkt des Endschlüsselrahmens zu bestimmen, zu dem der Startschlüsselrahmen erreicht ist. |
|
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 |