Export (0) Print
Expand All

Process.MainWindowHandle Property

Gets the window handle of the main window of the associated process.

[Visual Basic]
Public ReadOnly Property MainWindowHandle As IntPtr
[C#]
public IntPtr MainWindowHandle {get;}
[C++]
public: __property IntPtr get_MainWindowHandle();
[JScript]
public function get MainWindowHandle() : IntPtr;

Property Value

The system-generated window handle of the main window of the associated process.

Exceptions

Exception Type Condition
InvalidOperationException The MainWindowHandle is not defined because the process has exited.
NotSupportedException You are attempting to retrieve the MainWindowHandle for a process that is running on a remote computer.

Remarks

You can get the MainWindowHandle property only for processes that are running on the local computer. The MainWindowHandle property is a value that uniquely identifies the window that is associated with the process.

A process has a main window associated with it only if the process has a graphical interface. If the associated process does not have a main window, the MainWindowHandle value is zero. If you have just started a process and want to use its main window handle, consider using the WaitForInputIdle method to allow the process to finish starting, ensuring that the main window handle has been created. Otherwise, an exception will be thrown.

Windows 98 Platform Note:  This property is not available on this platform if you started the process with ProcessStartInfo.UseShellExecute set to true.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

.NET Framework Security: 

See Also

Process Class | Process Members | System.Diagnostics Namespace | MainWindowTitle | MainModule

Show:
© 2014 Microsoft