ISystemBackdropControllerWithTargets Interfaccia
Definizione
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.
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.IDisposablePublic Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController- Derivato
- Attributi
- Implementazioni
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 |
| SetTarget(WindowId, CompositionTarget) |
Connette un controller di sfondo di sistema a un oggetto |
Eventi
| StateChanged |
Si verifica quando lo stato dello sfondo del sistema è cambiato. |