Process.MainWindowHandle Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das Fensterhandle des Hauptfensters des zugeordneten Prozesses ab.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrEigenschaftswert
nativeint
Das vom System generierte Fensterhandle des Hauptfensters des zugeordneten Prozesses.
Ausnahmen
Dies MainWindowHandle ist nicht definiert, da der Prozess beendet wurde.
Sie versuchen, auf die Eigenschaft für einen Prozess zuzugreifen, der MainWindowHandle auf einem Remotecomputer ausgeführt wird. Diese Eigenschaft ist nur für Prozesse verfügbar, die auf dem lokalen Computer ausgeführt werden.
Hinweise
Das Hauptfenster ist das Fenster, das vom Prozess geöffnet wird, der derzeit den Fokus hat (das TopLevel Formular). Sie müssen die Refresh Methode verwenden, um das Process Objekt zu aktualisieren, um das aktuelle Hauptfensterhandle abzurufen, wenn es geändert wurde. Da das Fensterhandle im Allgemeinen zwischengespeichert wird, verwenden Refresh Sie vorher, um sicherzustellen, dass Sie das aktuelle Handle abrufen.
Sie können die MainWindowHandle Eigenschaft nur für Prozesse abrufen, die auf dem lokalen Computer ausgeführt werden. Die MainWindowHandle Eigenschaft ist ein Wert, der das Fenster eindeutig identifiziert, das dem Prozess zugeordnet ist.
Einem Prozess ist ein Hauptfenster nur zugeordnet, wenn der Prozess über eine grafische Benutzeroberfläche verfügt. Wenn der zugeordnete Prozess nicht über ein Hauptfenster verfügt, ist der MainWindowHandle Wert null. Der Wert ist auch null für Prozesse, die ausgeblendet wurden, d. h. Prozesse, die in der Taskleiste nicht sichtbar sind. Dies kann bei Prozessen der Fall sein, die als Symbole im Infobereich ganz rechts auf der Taskleiste angezeigt werden.
Wenn Sie gerade einen Prozess gestartet haben und dessen Hauptfensterhandle verwenden möchten, sollten Sie die WaitForInputIdle Methode verwenden, um den Startvorgang abzuschließen, und stellen Sie sicher, dass das Hauptfensterhandle erstellt wurde. Andernfalls wird eine Ausnahme ausgelöst.
