ISystemBackdropControllerWithTargets インターフェイス

リファレンス

定義

名前空間:: Microsoft.UI.Composition.SystemBackdrops

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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.IDisposable

Public Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController

派生: Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

属性: ContractVersionAttribute GuidAttribute

実装: ISystemBackdropController IClosable IDisposable

注釈

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

インターフェイスでは ISystemBackdropControllerWithTargets 、 ICompositionSupportsSystemBackdrop ターゲットをより細かく制御できます。ターゲットはいつでも追加および削除できます。すべてのターゲットが同じコンポジターを共有する必要があります。別 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 を持つまたは `AppWindow` に`HWND`システム背景コントローラーを接続します。 (継承元 ISystemBackdropController)

イベント

StateChanged

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

適用対象

Share via