次の方法で共有


ISystemBackdropControllerWithTargets インターフェイス

定義

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.IDisposable
Public Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController
派生
属性
実装

注釈

システムの背景は、基本的に、アクリルマイカなどの UI 素材を定義する CompositionBrush です。 このブラシは、システム コンポジターによって描画されます。 システム背景コントローラーは、システム背景マテリアルのレンダリングと、指定されたマテリアルのシステム ポリシーの処理の両方をカプセル化するオブジェクトです。 各素材には独自のコントローラーがあります。

インターフェイスでは ISystemBackdropControllerWithTargetsICompositionSupportsSystemBackdrop ターゲットをより細かく制御できます。 ターゲットはいつでも追加および削除できます。 すべてのターゲットが同じ コンポジターを共有する必要があります。 別 Compositor の を想定するターゲットを追加すると、無効な引数例外がスローされ、新しいターゲットは追加されません。

ISystemBackdropController インターフェイスには、アプリ固有のマテリアル ポリシー情報を提供するためのメカニズムが用意されていないため、代わりにアプリケーション ウィンドウ オブジェクトが必要です。 これに対し、インターフェイスには ISystemBackdropControllerWithTargets 、独自のアプリ固有のマテリアル ポリシーを指定できる SystemBackdropConfiguration オブジェクトが必要です。

システム背景コントローラーは、少なくとも 1 つのターゲットと共にオブジェクトが SystemBackdropConfiguration 提供されている場合にのみ、マテリアルをレンダリングします。 そうでない場合、何もレンダリングされません。 ターゲットを削除すると、マテリアルのレンダリングが停止します。 すべてのターゲットを削除すると、少なくとも 1 つのターゲットが追加されるまでコントローラーが無効になります。

プロパティ

State

システムの背景コントローラーの現在の状態を取得します。

メソッド

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)

指定したシステム背景ターゲットを追加して、マテリアルを描画します。

Dispose()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

RemoveAllSystemBackdropTargets()

すべてのシステム バックグラウンド ターゲットを削除します。

RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)

指定したシステム バックグラウンド ターゲットを削除します。

SetSystemBackdropConfiguration(SystemBackdropConfiguration)

システムの背景コントローラーに適用するアプリ固有のポリシーを設定します。

SetTarget(CoreWindow, CompositionTarget)

システム背景コントローラーを指定した CoreWindowに接続します。

(継承元 ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)

指定した WindowId を持つ または AppWindowHWNDシステム背景コントローラーを接続します。

(継承元 ISystemBackdropController)

イベント

StateChanged

システムの背景の状態が変更されたときに発生します。

適用対象