Partager via


DesktopWindowXamlSource Classe

Définition

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
Object IInspectable DesktopWindowXamlSource
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