Process.MainWindowHandle Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de venstergreep van het hoofdvenster van het bijbehorende proces op.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrWaarde van eigenschap
nativeint
De door het systeem gegenereerde venstergreep van het hoofdvenster van het bijbehorende proces.
Uitzonderingen
Het MainWindowHandle is niet gedefinieerd omdat het proces is afgesloten.
U probeert toegang te krijgen tot de MainWindowHandle eigenschap voor een proces dat wordt uitgevoerd op een externe computer. Deze eigenschap is alleen beschikbaar voor processen die worden uitgevoerd op de lokale computer.
Opmerkingen
Het hoofdvenster is het venster dat wordt geopend door het proces dat momenteel de focus heeft (het TopLevel formulier). U moet de Refresh methode gebruiken om het Process object te vernieuwen om de meest recente hoofdvenstergreep te krijgen als het is gewijzigd. In het algemeen kunt u, omdat de venstergreep in de cache is opgeslagen, vooraf gebruiken Refresh om te garanderen dat u de huidige ingang ophaalt.
U kunt de MainWindowHandle eigenschap alleen ophalen voor processen die worden uitgevoerd op de lokale computer. De MainWindowHandle eigenschap is een waarde die het venster dat aan het proces is gekoppeld, uniek identificeert.
Aan een proces is alleen een hoofdvenster gekoppeld als het proces een grafische interface heeft. Als het bijbehorende proces geen hoofdvenster heeft, is de MainWindowHandle waarde nul. De waarde is ook nul voor processen die zijn verborgen, dat wil gezegd, processen die niet zichtbaar zijn op de taakbalk. Dit kan het geval zijn voor processen die worden weergegeven als pictogrammen in het systeemvak, uiterst rechts op de taakbalk.
Als u net een proces hebt gestart en de hoofdvenstergreep wilt gebruiken, kunt u overwegen de WaitForInputIdle methode te gebruiken om het proces te laten beginnen, zodat de hoofdgreep van het venster is gemaakt. Anders wordt er een uitzondering gegenereerd.
