HwndSource Classe

Définition

public ref class HwndSource : System::Windows::PresentationSource, IDisposable, System::Windows::Interop::IKeyboardInputSink, System::Windows::Interop::IWin32Window

public class HwndSource : System.Windows.PresentationSource, IDisposable, System.Windows.Interop.IKeyboardInputSink, System.Windows.Interop.IWin32Window

type HwndSource = class
    inherit PresentationSource
    interface IDisposable
    interface IWin32Window
    interface IKeyboardInputSink

type HwndSource = class
    inherit PresentationSource
    interface IDisposable
    interface IKeyboardInputSink
    interface IWin32Window

Public Class HwndSource
Inherits PresentationSource
Implements IDisposable, IKeyboardInputSink, IWin32Window

Héritage

Object

DispatcherObject

PresentationSource

HwndSource

Implémente

IDisposable IKeyboardInputSink IWin32Window

Remarques

Un HwndSource implémente une fenêtre Win32 qui peut contenir du contenu WPF. Le contenu WPF dans la fenêtre est organisé, mesuré et rendu ; et est interactif à entrer. Étant donné que le HwndSource est spécifiquement conçu pour interagir avec Win32, cette classe expose plusieurs fonctionnalités Win32 de bas niveau. Vous pouvez utiliser cette classe pour effectuer les opérations suivantes :

• Spécifiez des styles de fenêtre, des styles de classe de fenêtre et des styles de fenêtre étendus.

• Crochetez la procédure de fenêtre.

• Fournir l’accès au handle de fenêtre (HWND).

• Détruisez la fenêtre.

La HwndSource classe est conçue pour l’interopérabilité générale et n’est pas conçue comme un wrapper HWND managé. En général, il ne fournit pas de méthodes managées pour manipuler la fenêtre ou de propriétés pour inspecter son état. Au lieu de cela, la HwndSource classe fournit l’accès au handle de fenêtre Win32 (HWND) par le biais de la Handle propriété, qui peut être passée au moyen de techniques PInvoke aux API Win32 afin de manipuler la fenêtre.

Construction

De nombreux aspects de ne HwndSource peuvent être spécifiés qu’au moment de la construction. Pour créer un HwndSource, commencez par créer une HwndSourceParameters structure et remplissez-la avec les paramètres souhaités. Ces paramètres sont les suivants :

• Styles de classe, de fenêtre et de fenêtre étendue. Vous devez utiliser PInvoke pour modifier les styles après la création de la fenêtre. Tous les styles ne peuvent pas être modifiés après la création de la fenêtre. Consultez la documentation Win32 avant de modifier les styles de fenêtre.

• Position initiale de la fenêtre.

• Taille initiale de la fenêtre, qui indique si la taille est spécifiée ou doit être déterminée à partir de la taille déterminée du contenu WPF.

• Fenêtre parente.

• HwndSourceHook à inclure dans la chaîne de procédures de fenêtre. Si vous spécifiez un crochet au moment de la construction, il reçoit tous les messages pour la fenêtre. Vous pouvez utiliser AddHook pour ajouter un hook après la création de la fenêtre.

• Paramètres de transparence. Une fenêtre de niveau supérieur peut être configurée pour être fusionnée avec les autres fenêtres du bureau en fonction de la transparence par pixel du contenu WPF. Pour activer cette opération, définissez la UsesPerPixelOpacity propriété dans le sur HwndSourceParameterstrue. Cette propriété ne peut être spécifiée qu’au moment de la construction, et uniquement par le biais de la signature du HwndSource(HwndSourceParameters) constructeur, et elle impose plusieurs limitations.

Une fois que vous avez renseigné la HwndSourceParameters structure, passez-la au HwndSource(HwndSourceParameters) constructeur pour .HwndSource

Durée de vie des objets

Un HwndSource est un objet CLR (Common Language Runtime) normal et sa durée de vie est gérée par le garbage collector. Étant donné que représente HwndSource une ressource non managée, HwndSource implémente IDisposable. L’appel Dispose synchrone détruit immédiatement la fenêtre Win32 si elle est appelée à partir du thread propriétaire. Si elle est appelée à partir d’un autre thread, la fenêtre Win32 est détruite de manière asynchrone. L’appel Dispose explicite à partir du code d’interopérabilité peut être nécessaire pour certains scénarios d’interopérabilité.

Procédures de fenêtre

La HwndSource classe implémente sa propre procédure de fenêtre. Cette procédure de fenêtre est utilisée pour traiter les messages de fenêtre importants, tels que ceux liés à la disposition, au rendu et à l’entrée. Toutefois, vous pouvez également crocheter la procédure de fenêtre pour votre propre usage. Vous pouvez spécifier votre propre hook pendant la construction en définissant la HwndSourceParameters.HwndSourceHook propriété, ou vous pouvez également utiliser AddHook et RemoveHook pour ajouter et supprimer des crochets après la création de la fenêtre. Les hooks sont appelés par ordre de premier sorti du dernier entrant, ce qui permet à vos crochets de s’exécuter avant le traitement intégré. Les crochets réels sont maintenus par une référence faible. Par conséquent, veillez à gérer la durée de vie de votre délégué de crochet.

Pour plus d’informations sur HwndSource et d’autres classes d’interopérabilité, consultez WPF et Win32 Interoperation.

Notez comment les constructeurs pour HwndSource prendre des paramètres qui ressemblent aux paramètres des fonctions Win32 telles que CreateWindowEx.

Les transformations d’échelle ne doivent pas être appliquées au RootVisual d’un HwndSource. Consultez Remarques pour RootVisual.

Constructeurs

Propriétés

Méthodes

Événements

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• HwndHost