ISystemBackdropController Interface

Référence

Définition

Espace de noms:: Microsoft.UI.Composition.SystemBackdrops

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Fournit des méthodes pour connecter un contrôleur d’arrière-plan système à une fenêtre.

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

Dérivé: Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.ISystemBackdropControllerWithTargets

Microsoft.UI.Composition.SystemBackdrops.MicaController

Attributs: ContractVersionAttribute GuidAttribute

Implémente: IClosable IDisposable

Exemples

Cet exemple montre comment dessiner le nouveau matériel Mica Windows 11 dans une fenêtre d’application Win32 à l’aide de 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);
}

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 de fond 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.

Vous pouvez dessiner un matériau à l’arrière de votre contenu en créant le correspondant ISystemBackdropController et en fournissant votre fenêtre et CompositionTarget à la méthode SetTarget du contrôleur. Si SetTarget réussit et retourne true, le contrôleur s’occupe de toute la gestion des matériaux, y compris le rendu de secours et toutes les stratégies système. Si SetTarget échoue et retourne false, cela signifie que le contrôleur n’a pas pu configurer le matériel souhaité en tant que toile de fond système, et qu’aucune modification n’a été apportée à .CompositionTarget

Les matériaux étant dessinés à l’aide des API Windows.UI.Composition , un objet CompositionTarget est requis sur lequel le matériel sera dessiné tout en arrière-plan du reste du contenu de l’application. Tout contenu d’application transparent s’affiche jusqu’au matériel choisi.

Méthodes

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.
SetTarget(CoreWindow, CompositionTarget)	Connecte un contrôleur d’arrière-plan système au spécifié `CoreWindow`.
SetTarget(WindowId, CompositionTarget)	Connecte un contrôleur d’arrière-plan système à un `HWND` ou `AppWindow` avec le WindowId spécifié.

S’applique à

Partager via