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

[アーティクル]
03/09/2024

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

構文

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

パラメーター

[in, optional] comparison

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

指定したオブジェクトは、IUIAnimationPriorityComparison インターフェイスを実装するか 、NULL にする必要があります。

「解説」を参照してください。

戻り値

メソッドが成功した場合は、S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。エラーコードの一覧については、「 Windows アニメーションエラーコード」を参照してください。

注釈

このメソッドを使用して優先度比較ハンドラーを設定すると、アプリケーションはストーリーボードを取り消すことによって、競合のスケジュールをいつ解決できるかを示すことができます。

スケジュールされたストーリーボードは、再生が開始されておらず、このメソッドに登録されている優先度比較オブジェクトが S_OKを返す場合にのみ取り消すことができます。キャンセルされたストーリーボードは、スケジュールから完全に削除されます。

比較パラメーターに NULL を渡すと、Windows アニメーションは、前に渡した優先度比較ハンドラーオブジェクトへの参照を解放します。この手法は、 IUIAnimationManager::Shutdown メソッドを呼び出すことなく、参照サイクルを中断するために不可欠な場合があります。

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista、および Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	uianimation.h
[DLL]	UIAnimation.dll