ISystemBackdropControllerWithTargets インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ISystemBackdropController インターフェイスを拡張し、システムの背景ターゲット、その構成、および状態の変更を管理する機能を使用します。
public interface class ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65537)]
/// [Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
struct ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65537)]
[Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
public interface ISystemBackdropControllerWithTargets : ISystemBackdropController, System.IDisposablePublic Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController- 派生
- 属性
- 実装
注釈
システムの背景は、基本的に、アクリルやマイカなどの UI 素材を定義する CompositionBrush です。 このブラシは、システム コンポジターによって描画されます。 システム背景コントローラーは、システム背景マテリアルのレンダリングと、指定されたマテリアルのシステム ポリシーの処理の両方をカプセル化するオブジェクトです。 各素材には独自のコントローラーがあります。
インターフェイスでは ISystemBackdropControllerWithTargets 、 ICompositionSupportsSystemBackdrop ターゲットをより細かく制御できます。 ターゲットはいつでも追加および削除できます。 すべてのターゲットが同じ コンポジターを共有する必要があります。 別 Compositor の を想定するターゲットを追加すると、無効な引数例外がスローされ、新しいターゲットは追加されません。
ISystemBackdropController インターフェイスには、アプリ固有のマテリアル ポリシー情報を提供するためのメカニズムが用意されていないため、代わりにアプリケーション ウィンドウ オブジェクトが必要です。 これに対し、インターフェイスには ISystemBackdropControllerWithTargets 、独自のアプリ固有のマテリアル ポリシーを指定できる SystemBackdropConfiguration オブジェクトが必要です。
システム背景コントローラーは、少なくとも 1 つのターゲットと共にオブジェクトが SystemBackdropConfiguration 提供されている場合にのみ、マテリアルをレンダリングします。 そうでない場合、何もレンダリングされません。 ターゲットを削除すると、マテリアルのレンダリングが停止します。 すべてのターゲットを削除すると、少なくとも 1 つのターゲットが追加されるまでコントローラーが無効になります。
プロパティ
| State |
システムの背景コントローラーの現在の状態を取得します。 |
メソッド
| AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop) |
指定したシステム背景ターゲットを追加して、マテリアルを描画します。 |
| Dispose() |
アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。 |
| RemoveAllSystemBackdropTargets() |
すべてのシステム バックグラウンド ターゲットを削除します。 |
| RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop) |
指定したシステム バックグラウンド ターゲットを削除します。 |
| SetSystemBackdropConfiguration(SystemBackdropConfiguration) |
システムの背景コントローラーに適用するアプリ固有のポリシーを設定します。 |
| SetTarget(CoreWindow, CompositionTarget) |
システム背景コントローラーを指定した |
| SetTarget(WindowId, CompositionTarget) |
指定した WindowId を持つ または |
イベント
| StateChanged |
システムの背景の状態が変更されたときに発生します。 |