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

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, который определяет материал пользовательского интерфейса, например акрил или Mica. Эта кисть рисуется системным композитатором. Системный контроллер фона — это объект, который инкапсулирует как отрисовку материала фона системы, так и обработку системной политики для данного материала. Каждый материал имеет свой собственный контроллер.

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

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

Методы

Dispose()

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

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

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

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