ISystemBackdropController Interfaccia

Definizione

Spazio dei nomi:
Microsoft.UI.Composition.SystemBackdrops
Modifica

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
ContractVersionAttribute GuidAttribute
Implementazioni
IClosable IDisposable

Esempio

Questo esempio mostra 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 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 di sfondo del sistema che la gestione dei criteri di sistema per il materiale specificato. Ogni materiale ha un proprio controller.

È possibile disegnare un materiale sul 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 tutta la gestione dei materiali, incluso 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 a CompositionTarget.

I materiali vengono disegnati utilizzando il Windows. Interfaccia utente. Le API di composizione, quindi è necessario un compositionTarget su cui il materiale verrà disegnato dietro il resto del contenuto dell'app. Qualsiasi contenuto dell'app con trasparenza verrà visualizzato attraverso il materiale scelto.

Metodi

Nome Descrizione
Dispose()

Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite.
SetTarget(CoreWindow, CompositionTarget)

Connette un controller di sfondo del sistema all'oggetto specificato CoreWindow.
SetTarget(WindowId, CompositionTarget)

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

Si applica a