WindowInteropHelper Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Unterstützt die Interoperabilität zwischen Windows Presentation Foundation (WPF) und Win32-Code.
public ref class WindowInteropHelper sealed
public sealed class WindowInteropHelper
type WindowInteropHelper = class
Public NotInheritable Class WindowInteropHelper
- Vererbung
-
WindowInteropHelper
Hinweise
Member dieser Klasse ermöglichen es dem Aufrufer, internen Zugriff auf win32 HWND und den übergeordneten HWND eines WPF Windowzu haben. Die richtigen Sicherheitsüberprüfungen werden von diesen Mitgliedern durchgeführt.
Verwenden Sie diese Klasse immer dann, wenn Sie ein spezifisches Objekt basierend auf dessen HWND benötigen.
Ein Beispielszenario ist, wenn Sie ein WPF-Dialogfeld in einer Win32-Anwendung hosten müssen. Initialisieren Sie das WindowInteropHelper WPF-Fensterobjekt für das Dialogfeld. Anschließend können Sie das WPF-Fensterhandle (HWND) aus der Handle Eigenschaft abrufen und den Besitzer für das WPF-Fenster mit der Owner Eigenschaft angeben. Das folgende Codebeispiel zeigt, wie Sie beim Hosten eines WPF-Dialogfelds in einer Win32-Anwendung verwenden WindowInteropHelper .
WindowInteropHelper wih = new WindowInteropHelper(myDialog);
wih.Owner = ownerHwnd;
myDialog.ShowDialog();
Dim wih As New WindowInteropHelper(myDialog)
wih.Owner = ownerHwnd
myDialog.ShowDialog()
Ein weiteres Szenario, das von dieser Klasse unterstützt wird, besteht darin, ein HwndSource Objekt aus einem WPF-Objekt Window abzurufen. Die HwndSource direkte Verarbeitung von Win32-Nachrichten über die AddHook Methode ermöglicht. HwndSource Mithilfe und AddHook anstelle eines Window Steuerelements können Sie nachrichten verarbeiten, die in WPF keine Entsprechung oder Behandlung haben. Erstellen Sie eine WindowInteropHelper mit der Window Quelle, und rufen Sie Handle dann auf WindowInteropHelper , um von HWND zu HwndSourcegelangen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| WindowInteropHelper(Window) |
Initialisiert eine neue Instanz der WindowInteropHelper Klasse für ein angegebenes Windows Presentation Foundation (WPF)-Fenster. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Handle |
Ruft das Fensterhandle für ein Windows Presentation Foundation (WPF)-Fenster ab, das zum Erstellen dieses WindowInteropHelperFensters verwendet wird. |
| Owner |
Dient zum Abrufen oder Festlegen des Handles des Windows Presentation Foundation (WPF)-Besitzerfensters. |
Methoden
| Name | Beschreibung |
|---|---|
| EnsureHandle() |
Erstellt den HWND des Fensters, wenn der HWND noch nicht erstellt wurde. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |