Язык

ISystemBackdropController Интерфейс

Определение

Пространство имен:
Microsoft.UI.Composition.SystemBackdrops
Изменить

Предоставляет методы для подключения системного контроллера фона к окну.

public interface class ISystemBackdropController : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
struct ISystemBackdropController : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
public interface ISystemBackdropController : System.IDisposable
Public Interface ISystemBackdropController
Implements IDisposable
Производный
Атрибуты
ContractVersionAttribute GuidAttribute
Реализации
IClosable IDisposable

Примеры

В этом примере показано, как нарисовать новый материал Windows 11 Mica в окне приложения Win32 с помощью C++/WinRT.

bool SetupBackdrop(winrt::Microsoft::UI::WindowId windowId, winrt::Windows::UI::Composition::CompositionTarget compositionTarget)
{
    winrt::Microsoft::UI::Composition::SystemBackdrops::MicaController micaController = winrt::MicaController();
    return micaController.SetTarget(windowId, compositionTarget);
}

Комментарии

Системный фон , по сути, compositionBrush, который определяет материал пользовательского интерфейса, например Акрил или Мика. Эта кисть рисуется системным компостатором. Контроллер фона системы — это объект, который инкапсулирует как отображение материала фона системы, так и обработку системной политики для данного материала. Каждый материал имеет свой собственный контроллер.

Вы можете нарисовать материал в задней части содержимого, создав соответствующее ISystemBackdropController и предоставив окно и CompositionTarget методу SetTarget контроллера. В случае SetTarget успешного выполнения и возврата контроллер выполняет все действия по обработке материалов, включая отрисовку trueрезервных копий и все системные политики. Если SetTarget сбой и возврат, falseэто означает, что контроллер не смог настроить нужный материал в качестве системного фона, и никакие изменения не были внесены в него CompositionTarget.

Материалы рисуются с помощью Windows. Пользовательского интерфейса. API композиции, поэтому требуется CompositionTarget, на котором материал будет вырисовываться в самом задней части остальной части содержимого приложения. Любое содержимое приложения с прозрачностью будет отображаться в выбранном материале.

Методы

Имя Описание
Dispose()

Выполняет определяемые приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов.
SetTarget(CoreWindow, CompositionTarget)

Подключает системный контроллер фона к указанному CoreWindow.
SetTarget(WindowId, CompositionTarget)

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

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