Process.MainWindowHandle Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá popisovač okna hlavního okna přidruženého procesu.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrHodnota vlastnosti
nativeint
Systémový popisovač okna hlavního okna přidruženého procesu.
Výjimky
Není definován, MainWindowHandle protože proces byl ukončen.
Pokoušíte se získat přístup k MainWindowHandle vlastnosti procesu, který běží na vzdáleném počítači. Tato vlastnost je k dispozici pouze pro procesy spuštěné v místním počítači.
Poznámky
Hlavní okno je okno otevřené procesem, který má aktuálně fokus ( TopLevel formulář). K aktualizaci objektu Refresh musíte použít metodu Process , abyste získali nejaktuálnější hlavní popisovač okna, pokud se změnil. Obecně platí, že protože popisovač okna je uložený v mezipaměti, použijte Refresh předem, abyste zajistili, že aktuální popisovač načtete.
Vlastnost můžete získat MainWindowHandle pouze pro procesy spuštěné v místním počítači. Vlastnost MainWindowHandle je hodnota, která jednoznačně identifikuje okno, které je přidruženo k procesu.
Proces má přidružené hlavní okno pouze v případě, že má proces grafické rozhraní. Pokud přidružený proces nemá hlavní okno, MainWindowHandle hodnota je nula. Hodnota je také nula pro procesy, které byly skryté, to znamená procesy, které nejsou viditelné na hlavním panelu. To může být případ procesů, které se zobrazují jako ikony v oznamovací oblasti úplně vpravo na hlavním panelu.
Pokud jste právě spustili proces a chcete použít jeho hlavní popisovač okna, zvažte použití WaitForInputIdle metody, která umožní dokončení procesu spuštění, a ujistěte se, že byl vytvořen hlavní popisovač okna. V opačném případě se vyvolá výjimka.
