Process.MainWindowHandle Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Ruft das Fensterhandle des Hauptfensters des zugeordneten Prozesses ab.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };

public IntPtr MainWindowHandle { get; }

member this.MainWindowHandle : nativeint

Public ReadOnly Property MainWindowHandle As IntPtr

Eigenschaftswert

IntPtr

nativeint

Das vom System generierte Fensterhandle des Hauptfensters des zugeordneten Prozesses.

Ausnahmen

InvalidOperationException

MainWindowHandle ist nicht definiert, da der Prozess beendet wurde.

NotSupportedException

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 Hauptfenster 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 das aktuellste Hauptfensterhandle zu erhalten, wenn 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 ein Hauptfenster zugeordnet, wenn der Prozess über eine grafische Benutzeroberfläche verfügt. Wenn der zugeordnete Prozess kein Hauptfenster 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 Hauptfensterhandle verwenden möchten, sollten Sie die WaitForInputIdle -Methode verwenden, damit der Prozess gestartet werden kann, um sicherzustellen, dass das Hauptfensterhandle erstellt wurde. Andernfalls wird eine Ausnahme ausgelöst.

Weitere Informationen

• MainWindowTitle
• MainModule