Process.MainWindowHandle Eigenschaft

Definition

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

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.

Gilt für:

Weitere Informationen