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 (par exemple, une application WPF ou Windows Forms) d’héberger des contrôles WinUI dans n’importe quel élément d’interface utilisateur associé à un handle de fenêtre (HWND).
/// [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 DesktopWindowXamlSource : 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 class DesktopWindowXamlSource : System.IDisposable
Public Class DesktopWindowXamlSource
Implements IDisposable
- Héritage
- Attributs
- Implémente
Remarques
DesktopWindowXamlSource est la classe principale de l’API d’hébergement XAML SDK d'application Windows. Cette API permet aux applications de bureau non-WASDK d’héberger tout contrôle dérivé de Microsoft.UI.Xaml.UIElement dans un élément d’interface utilisateur associé à un handle de fenêtre (HWND). Cette API peut être utilisée par des applications de bureau créées à l’aide de WPF, Windows Forms et de l’API Windows (Win32).
Si vous créez un objet DesktopWindowXamlSource avant de créer les objets UIElement qui y seront hébergés, l’infrastructure d’hébergement du contenu UIElement garantit que tous les objets sont initialisés sur le même thread. Si vous créez les objets UIElement avant de créer l’objet DesktopWindowXamlSource dans lequel ils seront hébergés, vous devez appeler Microsoft.UI.Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread avant d’instancier les objets 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 Microsoft.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. |
ShouldConstrainPopupsToWorkArea |
Obtient ou définit une valeur qui indique si les contrôles avec un comportement de type fenêtre contextuelle doivent être limités à la zone de travail. |
SiteBridge |
Obtient le DesktopSiteBridge associé à cet objet DesktopWindowXamlSource . |
SystemBackdrop |
Obtient ou définit l’arrière-plan système utilisé pour restituer des matériaux tels que Mica et Acrylique. |
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. |
Initialize(WindowId) |
Initialise une nouvelle instance de la classe DesktopWindowXamlSource. |
NavigateFocus(XamlSourceFocusNavigationRequest) |
Tente de mettre l’accent par programmation sur DesktopWindowXamlSource dans l’application de bureau. |
Événements
GotFocus |
Se produit lorsque desktopWindowXamlSource obtient le focus dans l’application de bureau (par exemple, lorsque 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 focusable dans desktopWindowXamlSource et appuie sur Tab). |
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour