ISystemBackdropControllerWithTargets 接口

  • 参考

定义

命名空间:
Microsoft.UI.Composition.SystemBackdrops
编辑

扩展 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
派生
属性
ContractVersionAttribute GuidAttribute
实现
ISystemBackdropController IClosable IDisposable

注解

系统背景本质上是一个 CompositionBrush，用于定义 UI 材料，例如 Acrylic 或 Mica。 此画笔由系统合成器绘制。 系统背景控制器是一个对象，它封装系统背景材料的呈现以及给定材料的系统策略处理。 每个材料都有自己的控制器。

接口 ISystemBackdropControllerWithTargets 更精细地控制 ICompositionSupportsSystemBackdrop 目标。 可以随时添加和删除目标。 所有目标必须共享同一 个 Compositor。 添加预期不同的 Compositor 目标将导致引发无效的参数异常，并且不会添加新目标。

ISystemBackdropController 接口不提供提供特定于应用的材料策略信息的机制，而是需要应用程序窗口对象。 相比之下，接口 ISystemBackdropControllerWithTargets 需要 一个 SystemBackdropConfiguration 对象，该对象允许你指定自己的特定于应用的材料策略。

仅当系统背景控制器已提供对象以及至少一个 SystemBackdropConfiguration 目标时，系统背景控制器才会呈现材料。 否则，它将不会呈现任何内容。 删除目标会使其停止呈现材料。 删除所有目标将禁用控制器，直到添加至少一个目标。

属性

State

获取系统背景控制器的当前状态。

方法

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)

添加要在其中绘制材料的指定系统背景目标。
Dispose()

执行与释放或重置非托管资源关联的应用程序定义的任务。
RemoveAllSystemBackdropTargets()

删除所有系统后台目标。
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)

删除指定的系统后台目标。
SetSystemBackdropConfiguration(SystemBackdropConfiguration)

设置要应用于系统背景控制器的应用特定策略。
SetTarget(CoreWindow, CompositionTarget)

将系统背景控制器连接到指定的 CoreWindow。

(继承自 ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)

使用指定的 WindowId 将系统背景控制器连接到 HWND 或 AppWindow 。

(继承自 ISystemBackdropController)

事件

StateChanged

当系统背景的状态发生更改时发生。

适用于