Process.MainWindowHandle Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera uchwyt okna głównego skojarzonego procesu.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrWartość właściwości
nativeint
Uchwyt okna generowanego przez system głównego okna skojarzonego procesu.
Wyjątki
Nie MainWindowHandle zdefiniowano elementu , ponieważ proces zakończył się.
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.
