Process.MainWindowHandle プロパティ

定義

関連付けられたプロセスのメイン ウィンドウで使用するウィンドウ ハンドルを取得します。

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使用してプロセスの開始を完了し、メイン ウィンドウ ハンドルが作成されていることを確認することを検討してください。 この操作を行わない場合、例外がスローされます。

適用対象

こちらもご覧ください