IUIAnimationStoryboard2::RepeatBetweenKeyframes メソッド (uianimation.h)
2 つのキーフレーム間にループを作成します。
構文
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
);
パラメーター
[in] startKeyframe
ループが開始されるキーフレーム。
[in] endKeyframe
ループが終了するキーフレーム。 endKeyframe は、ストーリーボードで startKeyframe よりも前に行う必要があります。
[in] cRepetition
ループを繰り返す回数。ループの最後の反復は、キーフレーム間で部分的に終了することができます。 値 0 は、ストーリーボードの指定された部分が再生されないことを示します。 UI_ANIMATION_REPEAT_INDEFINITELY (-1) の値は、ストーリーボードがトリミングまたは終了するまでループが無期限に繰り返されることを示します。
[in] repeatMode
ループイテレーションのパターン。
UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) の値は、ループの開始がキーフレーム (k1-k2、k2-k1>>、k1-k2> など) 間で交互に行われる必要があることを指定します。
UI_ANIMATION_REPEAT_MODE_NORMAL (0) の値は、ループの開始が最初のキーフレーム (k1-k2、k1-k2>>、k1-k2> など) で始まる必要があることを指定します。
[in] pIterationChangeHandler
各ループ イテレーション イベントのハンドラー。 既定値は 0 です。
[in] id
pIterationChangeHandler に渡すループ ID。 既定値は 0 です。
[in] fRegisterForNextAnimationEvent
true の場合、iUIAnimationManager2::EstimateNextEventTime メソッドによって返される次のアニメーション イベントまで、pIterationChangeHandler を時間間隔の見積もりに組み込むかどうかを指定します。 既定値は 0 または false です。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 Windows アニメーション エラー コード 」を参照してください。
注釈
このメソッドは、ストーリーボードの残りの部分を再生する前に、指定されたキーフレーム間の間隔を繰り返し再生するようにストーリーボードに指示します。 有限の繰り返し数を指定した場合、ループは常にその回数を再生します。 UI_ANIMATION_REPEAT_INDEFINITELY (-1) を指定すると、ストーリーボードが終了するまでループが繰り返されます。この場合、ループの現在のイテレーションが完了し、ストーリーボードの残りの部分が再生されます。 切り捨てられた場合も無期限にループするストーリーボードが終了します。
入れ子になったループと重複するループはサポートされていません。
キーフレームはストーリーボード内の時間を表し、切り替えの開始時刻または終了時刻を指定するために使用できます。 キーフレームは切り替えの最後に追加できるため、ストーリーボードが再生されるまで、ストーリーボードの先頭からのオフセットが不明な場合があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8、Windows 7、および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | uianimation.h |
| [DLL] | UIAnimation.dll |