Process.MainWindowHandle Egenskap

Definition

Hämtar fönsterhandtaget för huvudfönstret i den associerade processen.

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

Egenskapsvärde

IntPtr

nativeint

Det systemgenererade fönsterhandtaget för huvudfönstret i den associerade processen.

Undantag

MainWindowHandle Definieras inte eftersom processen har avslutats.

Du försöker komma åt MainWindowHandle egenskapen för en process som körs på en fjärrdator. Den här egenskapen är endast tillgänglig för processer som körs på den lokala datorn.

Kommentarer

Huvudfönstret är det fönster som öppnas av den process som för närvarande har fokus (formuläret TopLevel ). Du måste använda Refresh metoden för att uppdatera Process objektet för att få det senaste huvudfönsterhandtaget om det har ändrats. Eftersom fönsterhandtaget är cachelagrat använder Refresh du i förväg för att garantera att du hämtar det aktuella handtaget.

Du kan bara hämta MainWindowHandle egenskapen för processer som körs på den lokala datorn. Egenskapen MainWindowHandle är ett värde som unikt identifierar fönstret som är associerat med processen.

En process har ett huvudfönster som är associerat med det endast om processen har ett grafiskt gränssnitt. Om den associerade processen inte har något huvudfönster MainWindowHandle är värdet noll. Värdet är också noll för processer som har dolts, dvs. processer som inte visas i aktivitetsfältet. Detta kan vara fallet för processer som visas som ikoner i meddelandefältet längst till höger i aktivitetsfältet.

Om du precis har startat en process och vill använda huvudfönstrets handtag bör du överväga att använda WaitForInputIdle metoden för att låta processen slutföras, vilket säkerställer att huvudfönstrets handtag har skapats. Annars utlöses ett undantag.

Gäller för

Se även