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

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

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

構文

HRESULT SetCompressPriorityComparison(
  [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