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