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

Производный

Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

Атрибуты

ContractVersionAttribute GuidAttribute

Реализации

ISystemBackdropController IClosable IDisposable

Комментарии

Системный фон — это, по сути, CompositionBrush , который определяет материал пользовательского интерфейса , например Акрил или 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)	Подключает системный фоновый контроллер к объекту HWND или AppWindow с указанным идентификатором WindowId. (Унаследовано от ISystemBackdropController)

События

StateChanged

Происходит при изменении состояния фона системы.