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- 派生
- 属性
- 实现
注解
系统背景本质上是一个 CompositionBrush，用于定义 UI 材料，例如 Acrylic 或 Mica。 此画笔由系统合成器绘制。 系统背景控制器是一个对象，它封装系统背景材料的呈现以及给定材料的系统策略处理。 每个材料都有自己的控制器。
接口 ISystemBackdropControllerWithTargets 更精细地控制 ICompositionSupportsSystemBackdrop 目标。 可以随时添加和删除目标。 所有目标必须共享同一 个 Compositor。 添加预期不同的 Compositor 目标将导致引发无效的参数异常，并且不会添加新目标。
ISystemBackdropController 接口不提供提供特定于应用的材料策略信息的机制，而是需要应用程序窗口对象。 相比之下，接口 ISystemBackdropControllerWithTargets 需要 一个 SystemBackdropConfiguration 对象，该对象允许你指定自己的特定于应用的材料策略。
仅当系统背景控制器已提供对象以及至少一个 SystemBackdropConfiguration 目标时，系统背景控制器才会呈现材料。 否则，它将不会呈现任何内容。 删除目标会使其停止呈现材料。 删除所有目标将禁用控制器，直到添加至少一个目标。
属性
| State |
获取系统背景控制器的当前状态。 |
方法
| AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop) |
添加要在其中绘制材料的指定系统背景目标。 |
| Dispose() |
执行与释放或重置非托管资源关联的应用程序定义的任务。 |
| RemoveAllSystemBackdropTargets() |
删除所有系统后台目标。 |
| RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop) |
删除指定的系统后台目标。 |
| SetSystemBackdropConfiguration(SystemBackdropConfiguration) |
设置要应用于系统背景控制器的应用特定策略。 |
| SetTarget(CoreWindow, CompositionTarget) |
将系统背景控制器连接到指定的 |
| SetTarget(WindowId, CompositionTarget) |
使用指定的 WindowId 将系统背景控制器连接到 |
事件
| StateChanged |
当系统背景的状态发生更改时发生。 |