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)

Подключает системный фоновой контроллер к указанному CoreWindow.

(Унаследовано от ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)

Подключает системный фоновый контроллер к объекту HWND или AppWindow с указанным идентификатором WindowId.

(Унаследовано от ISystemBackdropController)

События

StateChanged

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

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