ISystemBackdropController Interface
Définition
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.
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.IDisposablePublic Interface ISystemBackdropController
Implements IDisposable- Dérivé
- Attributs
- Implémente
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é |
| SetTarget(WindowId, CompositionTarget) |
Connecte un contrôleur d’arrière-plan système à un |