IUIAnimationManager2::SetTrimPriorityComparison メソッド (uianimation.h)
スケジュールされたストーリーボードをトリミングできるかどうかを決定する優先度比較ハンドラーを設定します。
構文
HRESULT SetTrimPriorityComparison(
[in, optional] IUIAnimationPriorityComparison2 *comparison
);
パラメーター
[in, optional] comparison
トリミングの優先度比較ハンドラー。
指定したオブジェクトは 、IUIAnimationPriorityComparison インターフェイスを実装するか 、NULL にする必要があります。
詳細については、「解説」を参照してください。
戻り値
成功した場合 はS_OK を返します。それ以外の場合は 、HRESULT エラー コード。 エラー コードの一覧については、「 Windows アニメーション のエラー コード」を参照してください。
解説
このメソッドを使用して優先度比較ハンドラーを設定すると、スケジュールされたストーリーボードをトリミングすることで、スケジュールの競合をいつ解決できるかをアプリケーションで示すことができます。
スケジュールされたストーリーボードは、このメソッドに登録されている優先度比較オブジェクトが S_OKを返す場合にのみトリミングできます。 新しいストーリーボードがスケジュールされたストーリーボードをトリミングした場合、新しいストーリーボードがその変数のアニメーション化を開始した後、スケジュールされたストーリーボードは変数に影響を与えなくなります。
比較パラメーターに NULL を渡すと、Windows アニメーションは、前に渡したハンドラー オブジェクトへの参照を解放します。 この手法は、 IUIAnimationManager2::Shutdown メソッドを呼び出すことなく、参照サイクルを中断するために不可欠な場合があります。
要件
| サポートされている最小のクライアント | Windows 8、Windows 7、および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | uianimation.h |
| [DLL] | UIAnimation.dll |
関連項目
IUIAnimationManager2::SetCancelPriorityComparison
IUIAnimationManager2::SetCompressPriorityComparison