Handle Property
Collapse the table of content
Expand the table of content

NativeWindow.Handle Property


Gets the handle for this window.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

abstract Handle : nativeint with get
override Handle : nativeint with get

Property Value

Type: System.IntPtr

If successful, an IntPtr representing the handle to the associated native Win32 window; otherwise, 0 if no handle is associated with the window.

Use this method when calling Windows API methods that require a handle for a window or control.

The following code example demonstrates creating a window with a specific operating system window class name. The example creates a class that inherits from NativeWindow to accomplish this. The example also demonstrates overriding the OnHandleChange method to be notified when the Handle changes.

The MyNativeWindow class creates a new window with the ClassName set to BUTTON. This creates a Win32 button window. The location and size of the button is set, along with specifying additional window styles. The class demonstrates how to use the CreateHandle method and override the WndProc method to intercept window messages that are received. Although the example looks for the WM_ACTIVATEAPP message, this could be replaced in a real program with window messages specific to the type created.


Some control types send their window messages to the window parent instead of the window. See the Windows Platform SDK for more information.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft