関連付けられたプロセスのメイン ウィンドウで使用するウィンドウ ハンドルを取得します。
Public ReadOnly Property MainWindowHandle As IntPtr
[C#]
public IntPtr MainWindowHandle {get;}
[C++]
public: __property IntPtr get_MainWindowHandle();
[JScript]
public function get MainWindowHandle() : IntPtr;
プロパティ値
関連付けられたプロセスのメイン ウィンドウで使用する、システムが生成したウィンドウ ハンドル。
例外
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | プロセスが終了したため、 MainWindowHandle が定義されていません。 |
| NotSupportedException | リモート コンピュータで実行されているプロセスの MainWindowHandle を取得しようとしています。 |
解説
MainWindowHandle プロパティを取得できるのは、ローカル コンピュータで実行されているプロセスだけです。 MainWindowHandle プロパティは、プロセスに関連付けられたウィンドウを一意に識別する値です。
プロセスに関連付けられたメイン ウィンドウがあるのは、そのプロセスにグラフィカル インターフェイスがある場合だけです。関連付けられたプロセスにメイン ウィンドウがない場合、 MainWindowHandle 値はゼロです。プロセスの起動の直後にメイン ウィンドウ ハンドルを使用する場合は、 WaitForInputIdle メソッドを使用してプロセスの起動を終了し、メイン ウィンドウ ハンドルが作成されたことを確認してください。確認しない場合、例外がスローされます。
Windows 98 プラットフォームに関する注意点: ProcessStartInfo.UseShellExecute に true を設定してプロセスを開始した場合、このプロパティは、このプラットフォームでは利用できません。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- SecurityPermission (完全信頼を指定して System.Diagnostic.Process のメンバを呼び出すためのアクセス許可) PermissionState.Unrestricted (関連する列挙体)
参照
Process クラス | Process メンバ | System.Diagnostics 名前空間 | MainWindowTitle | MainModule