WindowsXamlManager Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt das WinUI-XAML-Framework in einer Nicht-Windows App SDK-Desktopanwendung (WASDK) dar (z. B. eine WPF- oder Windows Forms-Anwendung).
public ref class WindowsXamlManager sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WindowsXamlManager final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WindowsXamlManager : System.IDisposable
Public NotInheritable Class WindowsXamlManager
Implements IDisposable
- Vererbung
- Attribute
- Implementiert
Hinweise
WindowsXamlManager ist Teil der Windows App SDK XAML-Hosting-API. Mit dieser API können Nicht-WASDK-Desktopanwendungen alle Von Microsoft.UI.Xaml.UIElement abgeleiteten Steuerelemente in einem Benutzeroberflächenelement hosten, das einem Fensterhandle (HWND) zugeordnet ist. Diese API kann von Desktopanwendungen verwendet werden, die mit WPF, Windows Forms und der Windows-API (Win32) erstellt wurden.
Änderungen von WinAppSDK 1.4 zu WinAppSDK 1.5
WinAppSDK 1.4 | WinAppSDK 1.5 und höher |
---|---|
Die XAML-Runtime wird in einem Thread asynchron heruntergefahren, wenn alle WindowsXamlManager Objekte und DesktopWindowXamlSource in diesem Thread geschlossen oder zerstört wurden oder die DispatcherQueue , die für diesen Thread ausgeführt wird, heruntergefahren wird. |
Die XAML-Runtime wird nur für einen Thread heruntergefahren, wenn dispatcherQueue für den Thread heruntergefahren wird. |
WindowsXamlManager.InitializeForCurrentThread gibt jedes Mal ein neues Objekt zurück, wenn es aufgerufen wird. |
WindowsXamlManager.InitializeForCurrentThread gibt dieselbe WindowsXamlManager instance zurück, bis dispatcherQueue für den Thread heruntergefahren wird. |
Methoden
Close() |
Schließt alle Ressourcen, die von diesem WindowsXamlManager verwendet werden, und gibt sie asynchron frei. |
Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. |
GetForCurrentThread() |
Ruft das |
InitializeForCurrentThread() |
Initialisiert das WinUI-XAML-Framework in einer Nicht-Windows App SDK-Desktopanwendung (WASDK) (z. B. eine WPF- oder Windows Forms-Anwendung) im aktuellen Thread. |
Ereignisse
XamlShutdownCompletedOnThread |
Tritt auf, wenn die XAML-Runtime ihren Herunterfahrensprozess für den aktuellen Thread abgeschlossen hat. |