ISystemBackdropController Interfaccia

Riferimento

Definizione

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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: 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

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

Condividi tramite