共用方式為

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

範例

此範例示範如何使用 C++/WinRT，在 Win32 應用程式視窗中繪製新的Windows 11 Mica 材質。

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等UI 材質。 此筆刷是由系統撰寫器繪製。 系統背景控制站是一個物件，可封裝系統基底材質的轉譯，以及處理指定材質的系統原則。 每個材質都有自己的控制器。

您可以藉由建立對應的 ISystemBackdropController ，並將視窗和 CompositionTarget 提供給控制器的 SetTarget 方法，在內容背面繪製材質。 如果 SetTarget 成功並傳 true 回 ，控制器會負責處理所有材料處理，包括後援轉譯和所有系統原則。 如果 SetTarget 失敗並傳 false 回 ，表示控制器無法將所需的材質設定為系統基底，而且尚未對 進行 CompositionTarget 任何變更。

材質是使用 Windows.UI.Composition API 繪製的，因此需要 CompositionTarget ，材質將會在應用程式內容的其餘部分後方繪製。 任何具有透明度的應用程式內容都會向所選材質顯示。

方法

Dispose()

執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
SetTarget(CoreWindow, CompositionTarget)

將系統背景控制器連接到指定的 CoreWindow 。
SetTarget(WindowId, CompositionTarget)

使用指定的WindowId將系統背景控制器連接到 HWND 或 AppWindow 。

適用於