Process.MainWindowHandle Properti

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.Process.dll

Sumber:

Process.Unix.cs

Mendapatkan handel jendela dari jendela utama proses terkait.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };

public IntPtr MainWindowHandle { get; }

member this.MainWindowHandle : nativeint

Public ReadOnly Property MainWindowHandle As IntPtr

Nilai Properti

IntPtr

nativeint

Handel jendela yang dihasilkan sistem dari jendela utama proses terkait.

Pengecualian

InvalidOperationException

MainWindowHandle tidak didefinisikan karena proses telah keluar.

NotSupportedException

Anda mencoba mengakses MainWindowHandle properti untuk proses yang berjalan pada komputer jarak jauh. Properti ini hanya tersedia untuk proses yang berjalan pada komputer lokal.

Keterangan

Jendela utama adalah jendela yang dibuka oleh proses yang saat ini memiliki fokus ( TopLevel formulir). Anda harus menggunakan Refresh metode untuk menyegarkan Process objek untuk mendapatkan handel jendela utama terbaru jika telah berubah. Secara umum, karena handel jendela di-cache, gunakan Refresh sebelumnya untuk menjamin bahwa Anda akan mengambil handel saat ini.

Anda bisa mendapatkan MainWindowHandle properti hanya untuk proses yang berjalan di komputer lokal. Properti MainWindowHandle adalah nilai yang secara unik mengidentifikasi jendela yang terkait dengan proses.

Proses memiliki jendela utama yang terkait dengannya hanya jika proses memiliki antarmuka grafis. Jika proses terkait tidak memiliki jendela utama, nilainya MainWindowHandle adalah nol. Nilainya juga nol untuk proses yang telah disembunyikan, yaitu proses yang tidak terlihat di taskbar. Ini bisa menjadi kasus untuk proses yang muncul sebagai ikon di area pemberitahuan, di ujung kanan taskbar.

Jika Anda baru saja memulai proses dan ingin menggunakan handel jendela utamanya, pertimbangkan untuk menggunakan WaitForInputIdle metode untuk memungkinkan proses selesai dimulai, memastikan bahwa handel jendela utama telah dibuat. Jika tidak, pengecualian akan ditampilkan.

Lihat juga

• MainWindowTitle
• MainModule