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 du Kit de développement logiciel (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 les 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 seront hébergés dans celui-ci, l’infrastructure permettant d’héberger 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 de IClosable, il est recommandé de Fermer (Supprimer celui-ci dans .NET) lorsque vous avez terminé de l’utiliser.

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 le 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 contextuel doivent être limités à la zone de travail.

SiteBridge

Obtient le DesktopSiteBridge associé à cet objet DesktopWindowXamlSource.

SystemBackdrop

Obtient ou définit la toile de fond système utilisée pour restituer des matériaux tels que Mica et Acrylique.

Méthodes

Close()

Ferme et libère toutes les ressources utilisées par cette DesktopWindowXamlSource.

Dispose()

Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées.

Initialize(WindowId)

Initialise une nouvelle instance de la classe DesktopWindowXamlSource.

NavigateFocus(XamlSourceFocusNavigationRequest)

Tente de donner le focus par programmation à l' DesktopWindowXamlSource dans l’application de bureau.

Événements

GotFocus

Se produit lorsque l'DesktopWindowXamlSource se concentre dans l’application de bureau (par exemple, lorsque l’utilisateur appuie sur la touche Tab tandis que le focus se trouve sur l’élément juste avant le 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 le DesktopWindowXamlSource et appuie sur Tab).

S’applique à

Voir aussi