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
MainWindowHandle ist nicht definiert, da der Prozess beendet wurde.
Sie versuchen, auf die MainWindowHandle -Eigenschaft für einen Prozess zuzugreifen, der 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 Standard Fenster ist das Fenster, das von dem Prozess geöffnet wird, der derzeit den Fokus (das TopLevel Formular) hat. Sie müssen die Refresh -Methode verwenden, um das Process Objekt zu aktualisieren, um Standard Fensterhandle auf dem neuesten Stand zu erhalten, falls es sich geändert hat. Da das Fensterhandle zwischengespeichert ist, verwenden Refresh Sie im Allgemeinen vorab, um sicherzustellen, dass Sie das aktuelle Handle abrufen.
Sie erhalten die MainWindowHandle Eigenschaft nur für Prozesse, 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 nur dann ein Standard Fenster zugeordnet, wenn der Prozess über eine grafische Benutzeroberfläche verfügt. Wenn der zugeordnete Prozess kein Standard Fenster hat, ist der MainWindowHandle Wert null. Der Wert ist auch null für Prozesse, die ausgeblendet wurden, d. h. Prozesse, die nicht in der Taskleiste 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 Standard Fensterhandle verwenden möchten, sollten Sie die WaitForInputIdle -Methode verwenden, damit der Prozess gestartet werden kann, um sicherzustellen, dass das Standard Fensterhandle erstellt wurde. Andernfalls wird eine Ausnahme ausgelöst.
