IUIAnimationStoryboard::RepeatBetweenKeyframes メソッド (uianimation.h)
指定した 2 つのキーフレーム間にループを作成します。
構文
HRESULT RepeatBetweenKeyframes(
[in] UI_ANIMATION_KEYFRAME startKeyframe,
[in] UI_ANIMATION_KEYFRAME endKeyframe,
[in] INT32 repetitionCount
);
パラメーター
[in] startKeyframe
ループが開始されるキーフレーム。
[in] endKeyframe
ループが終了するキーフレーム。 endKeyframe を startKeyframe よりも前のストーリーボードで実行することはできません。
[in] repetitionCount
ループを繰り返す回数。このパラメーターは、0 または正の数値である必要があります。 UI_ANIMATION_REPEAT_INDEFINITELY (-1) を使用して、ストーリーボードがトリミングまたは終了するまでループを無期限に繰り返します。
戻り値
メソッドが成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 Windows アニメーション エラー コード 」を参照してください。
リターン コード | 説明 |
---|---|
|
開始キーフレームは、終了キーフレームの後に発生する可能性があります。 |
|
開始キーフレームに達したときの終了キーフレーム時間を特定できない場合があります。 |
|
ストーリーボードの 2 つの繰り返し部分が重複している可能性があります。 |
注釈
このメソッドは、ストーリーボードの残りの部分を再生する前に、指定されたキーフレーム間の間隔を繰り返し再生するようにストーリーボードに指示します。 有限の繰り返し数を指定した場合、ループは常にその回数を再生します。 UI_ANIMATION_REPEAT_INDEFINITELY (-1) を指定すると、ストーリーボードが終了するまでループが繰り返されます。この場合、ループの現在のイテレーションが完了し、ストーリーボードの残りの部分が再生されます。 切り捨てられた場合も無期限にループするストーリーボードが終了します。
入れ子になったループと重複するループはサポートされていません。
キーフレームはストーリーボード内の時間を表し、切り替えの開始時刻または終了時刻を指定するために使用できます。 キーフレームは切り替えの最後に追加できるため、ストーリーボードが再生されるまで、ストーリーボードの先頭からのオフセットが不明な場合があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7、Windows Vista、および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | uianimation.h |
[DLL] | UIAnimation.dll |