Process.MainWindowHandle プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
関連付けられたプロセスのメイン ウィンドウで使用するウィンドウ ハンドルを取得します。
public:
property IntPtr MainWindowHandle { IntPtr get(); };
public IntPtr MainWindowHandle { get; }
member this.MainWindowHandle : nativeint
Public ReadOnly Property MainWindowHandle As IntPtr
プロパティ値
-
IntPtr
nativeint
関連付けられたプロセスのメイン ウィンドウで使用する、システムが生成したウィンドウ ハンドル。
例外
プロセスが終了したため、MainWindowHandle が定義されていません。
リモート コンピューターで実行中のプロセスの MainWindowHandle プロパティにアクセスしようとしています。 このプロパティはローカル コンピューターで実行中のプロセスに対してのみ使用可能です。
注釈
メイン ウィンドウは、現在フォーカスがあるプロセスによって開かれたウィンドウ ( TopLevel フォーム) です。 このメソッドを Refresh 使用して、オブジェクトが Process 変更された場合に最新のメイン ウィンドウ ハンドルを取得するようにオブジェクトを更新する必要があります。 一般に、ウィンドウ ハンドルはキャッシュされるため、現在のハンドルを取得することを保証するために事前に使用 Refresh してください。
このプロパティは MainWindowHandle 、ローカル コンピューターで実行されているプロセスに対してのみ取得できます。 この MainWindowHandle プロパティは、プロセスに関連付けられているウィンドウを一意に識別する値です。
プロセスにメイン ウィンドウが関連付けられているのは、プロセスにグラフィカル インターフェイスがある場合のみです。 関連付けられているプロセスにメイン ウィンドウがない場合、 MainWindowHandle 値は 0 です。 この値は、非表示になっているプロセス、つまりタスク バーに表示されないプロセスの場合も 0 です。 これは、タスク バーの右端にある通知領域にアイコンとして表示されるプロセスの場合です。
プロセスを開始したばかりで、メイン ウィンドウ ハンドルを使用する場合は、メイン ウィンドウ ハンドルが作成されていることを確認して、プロセスの開始を完了できるように、このメソッドを使用 WaitForInputIdle することを検討してください。 この操作を行わない場合、例外がスローされます。