ISystemBackdropControllerWithTargets Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Расширяет интерфейс 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
- Производный
- Атрибуты
- Реализации
Комментарии
Системный фон — это, по сути, CompositionBrush , который определяет материал пользовательского интерфейса , например Акрил или Mica. Эта кисть рисуется составителем системы. Системный фоновой контроллер — это объект, который инкапсулирует как отрисовку материала системного фона, так и обработку системной политики для данного материала. Каждый материал имеет свой собственный контроллер.
Интерфейс ISystemBackdropControllerWithTargets
обеспечивает более детальное управление целевыми объектами ICompositionSupportsSystemBackdrop . Целевые объекты можно добавлять и удалять в любое время. Все целевые объекты должны совместно использовать один и тот же compositor. Добавление целевого объекта, ожидающего другого Compositor
, приведет к возникновению исключения недопустимого аргумента, а новый целевой объект не будет добавлен.
Интерфейс ISystemBackdropController не предоставляет механизм для предоставления сведений о политике материалов для конкретного приложения. Вместо этого требуется объект окна приложения. В отличие от этого, интерфейс ISystemBackdropControllerWithTargets
требует объекта SystemBackdropConfiguration , который позволяет указать собственную политику материалов для конкретного приложения.
Системный фоновой контроллер отрисовывает материал только в том случае, если ему предоставлен объект вместе по крайней SystemBackdropConfiguration
мере с одним целевым объектом. В противном случае он не будет отображать ничего. Удаление целевого объекта приведет к прекращению отрисовки материала. Удаление всех целевых объектов приведет к отключению контроллера до тех пор, пока не будет добавлен хотя бы один целевой объект.
Свойства
State |
Возвращает текущее состояние системного контроллера фона. |
Методы
AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop) |
Добавляет указанный целевой объект фона системы для рисования материала. |
Dispose() |
Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. |
RemoveAllSystemBackdropTargets() |
Удаляет все системные фоновые целевые объекты. |
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop) |
Удаляет указанный системный фоновый целевой объект. |
SetSystemBackdropConfiguration(SystemBackdropConfiguration) |
Задает политики, относящиеся к приложению, которые будут применяться к системным фонового контроллера. |
SetTarget(CoreWindow, CompositionTarget) |
Подключает системный фоновой контроллер к указанному |
SetTarget(WindowId, CompositionTarget) |
Подключает системный фоновый контроллер к объекту |
События
StateChanged |
Происходит при изменении состояния фона системы. |