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

IUIAnimationManager2::SetCancelPriorityComparison

IUIAnimationManager2::SetCompressPriorityComparison

IUIAnimationManager2::SetConcludePriorityComparison

IUIAnimationPriorityComparison