WindowInteropHelper Class

Reference

Definition

Namespace:: System.Windows.Interop

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Assists interoperation between Windows Presentation Foundation (WPF) and Win32 code.

public ref class WindowInteropHelper sealed

public sealed class WindowInteropHelper

type WindowInteropHelper = class

Public NotInheritable Class WindowInteropHelper

Inheritance: Object
WindowInteropHelper

Remarks

Members of this class allows the caller to have internal access to the Win32 HWND and the parent HWND of a WPF Window. The proper security checks are performed by those members.

Use this class whenever you need a more specific object based on its HWND.

An example scenario is if you need to host a WPF dialog box in a Win32 application. Initialize the WindowInteropHelper with a WPF window object for the dialog box. You can then get the WPF window's handle (HWND) from the Handle property and specify the owner for the WPF window with the Owner property. The following code example shows how to use WindowInteropHelper when hosting a WPF dialog box in a Win32 application.

WindowInteropHelper wih = new WindowInteropHelper(myDialog);
wih.Owner = ownerHwnd;
myDialog.ShowDialog();

Dim wih As New WindowInteropHelper(myDialog)
wih.Owner = ownerHwnd
myDialog.ShowDialog()

Another scenario supported by this class is to obtain a HwndSource object from a WPF Window object. The HwndSource enables direct processing of Win32 messages through the AddHook method. By using HwndSource and AddHook in place of a Window you can still handle messages that have no equivalent or handling in WPF. Create a WindowInteropHelper with the Window source, then call Handle on the WindowInteropHelper to get from HWND to HwndSource.

Constructors

WindowInteropHelper(Window)

Initializes a new instance of the WindowInteropHelper class for a specified Windows Presentation Foundation (WPF) window.

Properties

Handle	Gets the window handle for a Windows Presentation Foundation (WPF) window that is used to create this WindowInteropHelper.
Owner	Gets or sets the handle of the Windows Presentation Foundation (WPF) owner window.

Methods

EnsureHandle()	Creates the HWND of the window if the HWND has not been created yet.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to

Dela via