Process.MainWindowHandle Tulajdonság

Definíció

Lekéri a társított folyamat főablakának ablakfogópontját.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };
public IntPtr MainWindowHandle { get; }
member this.MainWindowHandle : nativeint
Public ReadOnly Property MainWindowHandle As IntPtr

Tulajdonság értéke

IntPtr

nativeint

A társított folyamat főablakának rendszer által generált ablakleírója.

Kivételek

Ez MainWindowHandle nincs definiálva, mert a folyamat kilépett.

Egy távoli számítógépen futó folyamat tulajdonságához próbál hozzáférni MainWindowHandle . Ez a tulajdonság csak a helyi számítógépen futó folyamatokhoz érhető el.

Megjegyzések

A főablak az a folyamat által megnyitott ablak, amely jelenleg a fókuszt (az űrlapot) jeleníti meg TopLevel . A módszerrel frissítenie kell Refresh az Process objektumot, hogy a legfrissebb főablak-leírót kapja, ha az megváltozott. Általánosságban elmondható, hogy mivel az ablakfogópont gyorsítótárazva van, előre használva Refresh garantálhatja, hogy lekéri az aktuális fogópontot.

A tulajdonságot csak a MainWindowHandle helyi számítógépen futó folyamatokhoz szerezheti be. A MainWindowHandle tulajdonság egy érték, amely egyedileg azonosítja a folyamathoz társított ablakot.

Egy folyamathoz csak akkor van főablak társítva, ha a folyamat grafikus felülettel rendelkezik. Ha a társított folyamatnak nincs főablaka, az MainWindowHandle érték nulla. Az érték a rejtett folyamatok, vagyis a tálcán nem látható folyamatok esetében is nulla. Ilyenek lehetnek azok a folyamatok, amelyek ikonként jelennek meg az értesítési területen, a tálca jobb szélén.

Ha éppen most indított el egy folyamatot, és a fő ablakfogópontját szeretné használni, fontolja meg a WaitForInputIdle metódus használatát a folyamat elindításának engedélyezéséhez, biztosítva a fő ablakfogópont létrehozását. Ellenkező esetben a rendszer kivételt küld.

A következőre érvényes:

Lásd még