共用方式為

ISystemBackdropControllerWithTargets 介面

  • 參考

定義

命名空間:
Microsoft.UI.Composition.SystemBackdrops
編輯

擴充 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
衍生
屬性
ContractVersionAttribute GuidAttribute
實作
ISystemBackdropController IClosable IDisposable

備註

系統背景基本上是CompositionBrush，可定義壓克力或Mica等UI 材質。 此筆刷是由系統撰寫器所繪製。 系統底板控制器是一種物件，可封裝系統底板材質的轉譯，以及處理指定材質的系統原則。 每個材質都有自己的控制器。

介面 ISystemBackdropControllerWithTargets 提供更細微的 ICompositionSupportsSystemBackdrop 目標控制。 您可以隨時新增和移除目標。 所有目標都必須共用相同的 Compositor。 新增預期不同的 Compositor 目標會導致擲回不正確引數例外狀況，且不會新增新的目標。

ISystemBackdropController介面不提供一種機制，讓您提供應用程式特定的材料原則資訊，而是需要應用程式視窗物件。 相反地， ISystemBackdropControllerWithTargets 介面需要 SystemBackdropConfiguration 物件，讓您指定自己的應用程式特定材料原則。

系統底板控制器只會在提供物件以及至少一個 SystemBackdropConfiguration 目標時轉譯材質。 如果沒有，則不會轉譯任何專案。 移除目標會讓它停止轉譯材質。 移除所有目標將會停用控制器，直到新增至少一個目標為止。

屬性

State

取得系統底板控制器的目前狀態。

方法

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)

加入要繪製材質的指定系統底板目標。
Dispose()

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

移除所有系統背景目標。
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)

移除指定的系統背景目標。
SetSystemBackdropConfiguration(SystemBackdropConfiguration)

設定要套用至系統底板控制器的應用程式特定原則。
SetTarget(CoreWindow, CompositionTarget)

將系統背景控制器連接到指定的 CoreWindow 。

(繼承來源 ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)

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

(繼承來源 ISystemBackdropController)

事件

StateChanged

發生于系統幕後的狀態已變更時。

適用於