Process.MainWindowHandle Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.Process.dll

Zdroj:

Process.Unix.cs

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 : nativeint

Public ReadOnly Property MainWindowHandle As IntPtr

Hodnota vlastnosti

IntPtr

nativeint

Systémově vygenerovaný popisovač okna hlavního okna přidruženého procesu.

Výjimky

InvalidOperationException

Hodnota MainWindowHandle není definována, protože proces byl ukončen.

NotSupportedException

Pokoušíte se získat přístup MainWindowHandle k vlastnosti pro proces, který je spuštěn 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ář). Musíte použít metodu Refresh k aktualizaci objektu Process , abyste získali nejaktuálnější popisovač hlavního okna, pokud se změnil. Obecně platí, že vzhledem k tomu, že je popisovač okna uložený v mezipaměti, použijte Refresh předem, abyste zajistili, že načtete aktuální popisovač.

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 přidružené k procesu.

K procesu je přidruženo 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é nulová pro skryté procesy, tj. 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ě zahájili proces a chcete použít jeho popisovač hlavního WaitForInputIdle okna, zvažte použití metody, která umožní dokončení procesu, a ujistěte se, že byl vytvořen popisovač hlavního okna. V opačném případě dojde k výjimce.

Viz také

• MainWindowTitle
• MainModule