WindowsXamlManager.InitializeForCurrentThread メソッド

定義

名前空間:

Microsoft.UI.Xaml.Hosting

現在のスレッドの非Windows アプリ SDK (WASDK) デスクトップ アプリケーション (WPF やWindows フォーム アプリケーションなど) で WinUI XAML フレームワークを初期化します。

public:
 static WindowsXamlManager ^ InitializeForCurrentThread();

 static WindowsXamlManager InitializeForCurrentThread();

public static WindowsXamlManager InitializeForCurrentThread();

function initializeForCurrentThread()

Public Shared Function InitializeForCurrentThread () As WindowsXamlManager

戻り値

WindowsXamlManager

WinUI XAML フレームワークへの参照を含む オブジェクト。

注釈

DesktopWindowXamlSource で Microsoft.UI.Xaml.UIElement オブジェクトをホストするデスクトップ アプリケーションで、現在のスレッドの内部 WinUI XAML フレームワークを初期化するには、このメソッドを呼び出します。 このメソッドを明示的に呼び出す必要があるのは、アプリケーションで Windows.UI.Xaml.UIElement オブジェクトを作成してから、それらをホストする DesktopWindowXamlSource オブジェクトを作成する場合のみです。 通常、アプリケーションでは、 DesktopWindowXamlSource をホストする親 UI オブジェクトがインスタンス化されるときに、このメソッドを呼び出す必要があります。

ホストされる Windows.UI.Xaml.UIElement オブジェクトを作成する前に DesktopWindowXamlSource オブジェクトを作成する場合は、このメソッドを呼び出す必要はありません。 このシナリオでは、 DesktopWindowXamlSource オブジェクトをインスタンス化すると、WinUI XAML フレームワークが初期化されます。

このメソッドは、WinUI XAML フレームワークへの参照を含む WindowsXamlManager オブジェクトを返します。 任意の 1 つのスレッドで WindowsXamlManager オブジェクトを必要な数だけ作成できます。 ただし、各オブジェクトには WinUI XAML フレームワークへの参照が保持されるため、XAML リソースが最終的にリリースされるようにするには、オブジェクトを 閉じる (.NET で破棄 する) 必要があります。

注意

Windows アプリ SDK 1.4 では、InitializeForCurrentThread呼び出されるたびに新しいオブジェクトが返されます。

Windows アプリ SDK 1.5 以降では、InitializeForCurrentThreadスレッドの DispatcherQueue がシャットダウンされるまで、同じWindowsXamlManagerインスタンスを返します。