ISystemBackdropControllerWithTargets 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

Estende l'interfaccia ISystemBackdropController con la possibilità di gestire le destinazioni di sfondo del sistema, la relativa configurazione e le modifiche dello stato.

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

Derivato: Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

Attributi: ContractVersionAttribute GuidAttribute

Implementazioni: ISystemBackdropController IClosable IDisposable

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.

L'interfaccia ISystemBackdropControllerWithTargets offre un controllo più granulare delle destinazioni ICompositionSupportsSystemBackdrop . Le destinazioni possono essere aggiunte e rimosse in qualsiasi momento. Tutte le destinazioni devono condividere lo stesso compositore. L'aggiunta di una destinazione che prevede un'eccezione diversa Compositor causerà l'generazione di un'eccezione di argomento non valida e la nuova destinazione non verrà aggiunta.

L'interfaccia ISystemBackdropController non fornisce un meccanismo per fornire informazioni sui criteri di materiale specifiche dell'app e richiede invece l'oggetto finestra dell'applicazione. Al contrario, l'interfaccia ISystemBackdropControllerWithTargets richiede un oggetto SystemBackdropConfiguration che consente di specificare i propri criteri di materiale specifici dell'app.

Un controller di sfondo del sistema eseguirà il rendering di un materiale solo se è stato fornito un SystemBackdropConfiguration oggetto insieme a almeno una destinazione. In caso contrario, non eseguirà il rendering di nulla. La rimozione di una destinazione impedirà il rendering del materiale. La rimozione di tutte le destinazioni disabilita il controller fino a quando non viene aggiunta almeno una destinazione.

Proprietà

State

Ottiene lo stato corrente del controller di sfondo del sistema.

Metodi

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Aggiunge la destinazione dello sfondo del sistema specificato su cui disegnare il materiale.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
RemoveAllSystemBackdropTargets()	Rimuove tutte le destinazioni in background del sistema.
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Rimuove la destinazione in background del sistema specificata.
SetSystemBackdropConfiguration(SystemBackdropConfiguration)	Imposta i criteri specifici dell'app da applicare al controller di sfondo del sistema.
SetTarget(CoreWindow, CompositionTarget)	Connette un controller di sfondo di sistema all'oggetto specificato `CoreWindow`. (Ereditato da ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)	Connette un controller di sfondo di sistema a un oggetto `HWND` o `AppWindow` con l'oggetto WindowId specificato. (Ereditato da ISystemBackdropController)

Eventi

StateChanged

Si verifica quando lo stato dello sfondo del sistema è cambiato.

Si applica a

Condividi tramite