Process.MainWindowHandle Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Diagnostics
Zestaw:
System.Diagnostics.Process.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
Process.Unix.cs
Źródło:
Process.Unix.cs
Źródło:
Process.Unix.cs

Pobiera uchwyt okna głównego skojarzonego procesu.

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

Wartość właściwości

IntPtr

nativeint

Uchwyt okna generowanego przez system głównego okna skojarzonego procesu.

Wyjątki

InvalidOperationException

Nie MainWindowHandle zdefiniowano elementu , ponieważ proces zakończył się.

NotSupportedException

Próbujesz uzyskać dostęp do MainWindowHandle właściwości dla procesu uruchomionego na komputerze zdalnym. Ta właściwość jest dostępna tylko dla procesów uruchomionych na komputerze lokalnym.

Uwagi

Głównym oknem jest okno otwarte przez proces, który obecnie ma fokus ( TopLevel formularz). Należy użyć Refresh metody , aby odświeżyć obiekt, Process aby uzyskać najbardziej aktualny uchwyt okna głównego, jeśli uległ zmianie. Ogólnie rzecz biorąc, ponieważ uchwyt okna jest buforowany, użyj Refresh wcześniej, aby zagwarantować pobranie bieżącego uchwytu.

Właściwość można pobrać MainWindowHandle tylko dla procesów uruchomionych na komputerze lokalnym. Właściwość MainWindowHandle jest wartością, która jednoznacznie identyfikuje okno skojarzone z procesem.

Proces ma skojarzone z nim okno główne tylko wtedy, gdy proces ma interfejs graficzny. Jeśli skojarzony proces nie ma okna głównego, MainWindowHandle wartość to zero. Wartość jest również równa zero dla procesów, które zostały ukryte, czyli procesy, które nie są widoczne na pasku zadań. Może to mieć miejsce w przypadku procesów, które są wyświetlane jako ikony w obszarze powiadomień po prawej stronie paska zadań.

Jeśli właśnie rozpoczęto proces i chcesz użyć głównego uchwytu okna, rozważ użycie WaitForInputIdle metody , aby umożliwić rozpoczęcie procesu, upewniając się, że główny uchwyt okna został utworzony. W przeciwnym razie zostanie zgłoszony wyjątek.

Dotyczy

Zobacz też