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

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

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

構文

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

パラメーター

[in, optional] comparison

結論の優先度比較ハンドラー。指定したオブジェクトは、IUIAnimationPriorityComparison インターフェイスを実装するか 、NULL にする必要があります。「解説」を参照してください。

戻り値

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

注釈

このメソッドを使用して優先度比較ハンドラーを設定すると、スケジュールされたストーリーボードを終了することで、スケジュールの競合を解決できるタイミングをアプリケーションで示すことができます。

スケジュールされたストーリーボードは、繰り返し数がUI_ANIMATION_REPEAT_INDEFINITELY のループが含まれており、このメソッドに登録されている優先度比較オブジェクトが S_OKを返す場合にのみ終了できます。ストーリーボードが終了すると、ループの現在の繰り返しが完了し、ストーリーボードのリマインダーが再生されます。

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

要件

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