WindowsXamlManager.InitializeForCurrentThread Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Hosting

Initialise l’infrastructure XAML WinUI dans une application de bureau non SDK d'application Windows (WASDK) (par exemple, une application WPF ou Windows Forms) sur le thread actuel.

public:
 static WindowsXamlManager ^ InitializeForCurrentThread();

 static WindowsXamlManager InitializeForCurrentThread();

public static WindowsXamlManager InitializeForCurrentThread();

function initializeForCurrentThread()

Public Shared Function InitializeForCurrentThread () As WindowsXamlManager

Retours

WindowsXamlManager

Objet qui contient une référence à l’infrastructure XAML WinUI.

Remarques

Appelez cette méthode pour initialiser l’infrastructure XAML WinUI interne pour le thread actuel dans une application de bureau dans laquelle vous souhaitez héberger des objets Microsoft.UI.Xaml.UIElement dans un DesktopWindowXamlSource. Vous devez appeler explicitement cette méthode uniquement si votre application crée les objets Windows.UI.Xaml.UIElement avant de créer l’objet DesktopWindowXamlSource qui les hébergera. Votre application doit généralement appeler cette méthode lorsque l’objet d’interface utilisateur parent qui héberge DesktopWindowXamlSource est instancié.

Si vous créez un objet DesktopWindowXamlSource avant de créer les objets Windows.UI.Xaml.UIElement qui y seront hébergés, vous n’avez pas besoin d’appeler cette méthode. Dans ce scénario, l’infrastructure XAML WinUI est initialisée pour vous lorsque vous instanciez l’objet DesktopWindowXamlSource .

Cette méthode retourne un objet WindowsXamlManager qui contient une référence à l’infrastructure XAML WinUI. Vous pouvez créer autant d’objets WindowsXamlManager que vous le souhaitez sur un thread donné. Toutefois, étant donné que chaque objet contient une référence à l’infrastructure XAML WinUI, vous devez fermer (supprimer dans .NET) les objets pour vous assurer que les ressources XAML sont finalement libérées.

Notes

Dans SDK d'application Windows 1.4, InitializeForCurrentThread retourne un nouvel objet chaque fois qu’il est appelé.

Dans SDK d'application Windows version 1.5 ou ultérieure, InitializeForCurrentThread retourne le même WindowsXamlManager instance jusqu’à ce que dispatcherQueue sur le thread s’arrête.