DesktopWindowXamlSource Classe
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.
Permet à une application de bureau non UWP (par exemple, une application WPF ou Windows Forms) d’héberger des contrôles UWP dans n’importe quel élément d’interface utilisateur associé à un handle de fenêtre (HWND).
/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Xaml.Hosting.HostingContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DesktopWindowXamlSource : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Xaml.Hosting.HostingContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DesktopWindowXamlSource : System.IDisposable
Public Class DesktopWindowXamlSource
Implements IDisposable
- Héritage
- Attributs
- Implémente
Configuration requise pour Windows
Famille d’appareils |
Windows Desktop Extension SDK (introduit dans 10.0.17763.0)
|
API contract |
Windows.UI.Xaml.Hosting.HostingContract (introduit dans v3.0)
|
Remarques
DesktopWindowXamlSource est la classe main de l’API d’hébergement XAML UWP. Cette API permet aux applications de bureau non UWP d’héberger n’importe quel contrôle dérivé de Windows.UI.Xaml.UIElement) dans un élément d’interface utilisateur associé à un handle de fenêtre (HWND). Cette API peut être utilisée par les applications de bureau créées à l’aide de WPF, de Windows Forms et de l’API Windows (Win32). Pour plus d’informations, consultez Utilisation de l’API d’hébergement XAML UWP dans une application de bureau.
Si vous créez un objet DesktopWindowXamlSource avant de créer les objets Windows.UI.Xaml.UIElement qui y seront hébergés, l’infrastructure d’hébergement du contenu Windows.UI.Xaml.UIElement garantit que tous les objets sont initialisés sur le même thread. Si vous créez les objets Windows.UI.Xaml.UIElement avant de créer l’objet DesktopWindowXamlSource dans lequel ils seront hébergés, vous devez appeler WindowsXamlManager.InitializeForCurrentThread avant d’instancier les objets Windows.UI.Xaml.UIElement .
Étant donné que DesktopWindowXamlSource dérive d’IClosable, il est recommandé de le fermer (le supprimer dans .NET) lorsque vous en avez terminé.
Constructeurs
DesktopWindowXamlSource() |
Initialise une nouvelle instance de la classe DesktopWindowXamlSource. |
Propriétés
Content |
Obtient ou définit l’objet Windows.UI.Xaml.UIElement que vous souhaitez héberger dans l’application de bureau. |
HasFocus |
Obtient une valeur qui indique si DesktopWindowXamlSource a actuellement le focus dans l’application de bureau. |
Méthodes
Close() |
Ferme et libère toutes les ressources utilisées par ce DesktopWindowXamlSource. |
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. |
NavigateFocus(XamlSourceFocusNavigationRequest) |
Tente de donner le focus par programmation à DesktopWindowXamlSource dans l’application de bureau. |
Événements
GotFocus |
Se produit lorsque desktopWindowXamlSource obtient le focus dans l’application de bureau (par exemple, l’utilisateur appuie sur la touche Tab pendant que le focus est sur l’élément juste avant desktopWindowXamlSource). |
TakeFocusRequested |
Se produit lorsque l’application de bureau hôte reçoit une demande de retour au focus de l’objet DesktopWindowXamlSource (par exemple, l’utilisateur se trouve sur le dernier élément pouvant être mis au point dans DesktopWindowXamlSource et appuie sur Tab). |