ISystemBackdropControllerWithTargets Interface

Définition

Espace de noms:

Microsoft.UI.Composition.SystemBackdrops

Étend l’interface ISystemBackdropController avec la possibilité de gérer les cibles de l’arrière-plan du système, leur configuration et les changements d’état.

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

Dérivé

Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

Attributs

ContractVersionAttribute GuidAttribute

Implémente

ISystemBackdropController IClosable IDisposable

Remarques

Un arrière-plan système est essentiellement un CompositionBrush qui définit un matériau d’interface utilisateur tel que Acrylique ou Mica. Ce pinceau est dessiné par le compositeur système. Un contrôleur d’arrière-plan système est un objet qui encapsule à la fois le rendu du matériau d’arrière-plan système ainsi que la gestion de la stratégie système pour le matériel donné. Chaque matériau a son propre contrôleur.

L’interface ISystemBackdropControllerWithTargets fournit un contrôle plus précis des cibles ICompositionSupportsSystemBackdrop . Des cibles peuvent être ajoutées et supprimées à tout moment. Toutes les cibles doivent partager le même compositor. L’ajout d’une cible qui s’attend à une autre Compositor entraîne la levée d’une exception d’argument non valide et la nouvelle cible ne sera pas ajoutée.

L’interface ISystemBackdropController ne fournit pas de mécanisme permettant de fournir des informations de stratégie matérielle spécifiques à l’application, et nécessite plutôt l’objet fenêtre d’application. En revanche, l’interface ISystemBackdropControllerWithTargets nécessite un objet SystemBackdropConfiguration qui vous permet de spécifier votre propre stratégie matérielle spécifique à l’application.

Un contrôleur d’arrière-plan système ne rendra un matériau que s’il a été fourni un SystemBackdropConfiguration objet avec au moins une cible. Si ce n’est pas le cas, il ne rendra rien. La suppression d’une cible l’empêche de rendre le matériau. La suppression de toutes les cibles désactive le contrôleur jusqu’à ce qu’au moins une cible soit ajoutée.

Propriétés

State

Obtient l’état actuel du contrôleur d’arrière-plan système.

Méthodes

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Ajoute la cible d’arrière-plan système spécifiée sur laquelle dessiner le matériau.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
RemoveAllSystemBackdropTargets()	Supprime toutes les cibles d’arrière-plan système.
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Supprime la cible d’arrière-plan système spécifiée.
SetSystemBackdropConfiguration(SystemBackdropConfiguration)	Définit les stratégies spécifiques à l’application à appliquer au contrôleur d’arrière-plan système.
SetTarget(CoreWindow, CompositionTarget)	Connecte un contrôleur de fond système au spécifié CoreWindow. (Hérité de ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)	Connecte un contrôleur d’arrière-plan système à un HWND ou AppWindow avec le WindowId spécifié. (Hérité de ISystemBackdropController)

Événements

StateChanged

Se produit lorsque l’état de l’arrière-plan système a changé.