ISystemBackdropController Interfaccia

Definizione

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

Derivato

Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.ISystemBackdropControllerWithTargets

Microsoft.UI.Composition.SystemBackdrops.MicaController

Attributi

ContractVersionAttribute GuidAttribute

Implementazioni

IClosable IDisposable

Esempio

In questo esempio viene illustrato come disegnare il nuovo materiale Windows 11 Mica in una finestra dell'app Win32 usando 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);
}

Commenti

Uno sfondo di sistema è essenzialmente un oggetto CompositionBrush che definisce un materiale dell'interfaccia utente , ad esempio Acrilico o Mica. Questo pennello viene disegnato dal compositore di sistema. Un controller di sfondo del sistema è un oggetto che incapsula sia il rendering del materiale dello sfondo del sistema che la gestione dei criteri di sistema per il materiale specificato. Ogni materiale ha il proprio controller.

È possibile disegnare un materiale al retro del contenuto creando il corrispondente ISystemBackdropController e fornendo la finestra e CompositionTarget al metodo SetTarget del controller. Se SetTarget ha esito positivo e restituisce true, il controller si occupa di tutte le operazioni di gestione dei materiali, tra cui il rendering del fallback e tutti i criteri di sistema. Se SetTarget ha esito negativo e restituisce false, significa che il controller non è riuscito a configurare il materiale desiderato come sfondo di sistema e non sono state apportate modifiche all'oggetto CompositionTarget.

I materiali vengono disegnati usando le API Windows.UI.Composition , quindi è necessario un oggetto CompositionTarget su cui verrà disegnato il materiale dietro il resto del contenuto dell'app. Qualsiasi contenuto dell'app con trasparenza mostrerà attraverso il materiale scelto.

Metodi

Si applica a