IUIAnimationManager2::SetCancelPriorityComparison メソッド (uianimation.h)

スケジュールされたストーリーボードを取り消すことができるかどうかを決定する優先度比較ハンドラーを設定します。

構文

HRESULT SetCancelPriorityComparison(
  [in, optional] IUIAnimationPriorityComparison2 *comparison
);

パラメーター

[in, optional] comparison

キャンセルの優先度比較ハンドラー。

指定したオブジェクトは 、IUIAnimationPriorityComparison2 インターフェイスを実装するか 、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::SetCompressPriorityComparison

IUIAnimationManager2::SetConcludePriorityComparison

IUIAnimationManager2::SetTrimPriorityComparison

IUIAnimationPriorityComparison