ISystemBackdropController Interfaccia

Definizione

Fornisce metodi per connettere un controller di sfondo di sistema a una finestra.

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
Attributi
Implementazioni

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

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

SetTarget(CoreWindow, CompositionTarget)

Connette un controller di sfondo di sistema all'oggetto specificato CoreWindow.

SetTarget(WindowId, CompositionTarget)

Connette un controller di sfondo di sistema a un oggetto HWND o AppWindow con l'oggetto WindowId specificato.

Si applica a