IUIAnimationTransition

遷移(トランジション)を定義します。遷移は、アニメーション変数が時間の経過とともにどのように変化するかを決定します。

IUIAnimationTransition は、IUIAnimationVariable インターフェイスおよび IUIAnimationStoryboard インターフェイスとともに、 アプリケーションにアニメーションを追加するために使用される主要なインターフェイスの 1 つです。

UIAnimationTransitionLibrary は、 標準的な遷移のライブラリを実装します。

遷移の初期値を設定します。

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。エラーコードの一覧については、Windows Animation Error Codes を参照してください。

このメソッドは、遷移がストーリーボードに追加された後に呼び出してはいけません。

遷移の初期速度を設定します。

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。エラーコードの一覧については、Windows Animation Error Codes を参照してください。

このメソッドは、遷移がストーリーボードに追加された後に呼び出してはいけません。

遷移の継続時間が現在判明しているかどうかを判定します。

継続時間が判明している場合は S_OK、判明していない場合は S_FALSE を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については、Windows Animation Error Codes を参照してください。

このメソッドは、遷移が追加されたストーリーボードがスケジュールされているか再生中であるときには呼び出してはいけません。

例

例については、IUIAnimationTransition::GetDuration を参照してください。

遷移の継続時間を取得します。(IUIAnimationTransition.GetDuration)

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。エラーコードの一覧については、Windows Animation Error Codes を参照してください。

アプリケーションは通常、このメソッドを呼び出す前に IUIAnimationTransition::IsDurationKnown メソッドを呼び出す必要があります。このメソッドは、遷移が追加されたストーリーボードがスケジュールされているか再生中であるときには呼び出してはいけません。

例

次の例は、遷移の継続時間を取得する方法を示します。

hr = pTransition->IsDurationKnown();
if (SUCCEEDED(hr))
{
    bool fDurationKnown = (hr == S_OK); 
    if (fDurationKnown)
    {
        UI_ANIMATION_SECONDS duration;
        hr = pTransition->GetDuration(&duration);
        if (SUCCEEDED(hr))
        {        
            ...
        }
    }
    else
    {
        ...
    }
}