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

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

Применяется к

Поделиться через