Process.MainWindowHandle Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
nativeint
Handel jendela yang dihasilkan sistem dari jendela utama proses terkait.
Pengecualian
MainWindowHandle tidak didefinisikan karena proses telah keluar.
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.