Process.MainWindowHandle Propriété

  • Référence

Définition

Espace de noms:
System.Diagnostics
Assembly:
System.Diagnostics.Process.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Obtient le handle de la fenêtre principale du processus associé.

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

Valeur de propriété

IntPtr

nativeint

Handle, généré par le système, de la fenêtre principale du processus associé.

Exceptions

InvalidOperationException

La propriété MainWindowHandle n’est pas définie, car le processus s’est fermé.

NotSupportedException

Vous tentez d’accéder à la propriété MainWindowHandle d’un processus en cours d’exécution sur un ordinateur distant. Cette propriété est disponible uniquement pour les processus en cours d’exécution sur l’ordinateur local.

Remarques

La fenêtre principale est la fenêtre ouverte par le processus qui a actuellement le focus (le TopLevel formulaire). Vous devez utiliser la Refresh méthode pour actualiser l’objet Process pour obtenir le handle de fenêtre principale le plus à jour s’il a changé. En général, étant donné que le handle de fenêtre est mis en cache, utilisez Refresh au préalable pour vous assurer que vous récupérerez le handle actuel.

Vous pouvez obtenir la MainWindowHandle propriété uniquement pour les processus qui s’exécutent sur l’ordinateur local. La MainWindowHandle propriété est une valeur qui identifie de façon unique la fenêtre associée au processus.

Un processus a une fenêtre principale associée uniquement si le processus a une interface graphique. Si le processus associé n’a pas de fenêtre principale, la MainWindowHandle valeur est égale à zéro. La valeur est également égale à zéro pour les processus qui ont été masqués, c’est-à-dire les processus qui ne sont pas visibles dans la barre des tâches. Cela peut être le cas pour les processus qui apparaissent sous forme d’icônes dans la zone de notification, à l’extrême droite de la barre des tâches.

Si vous venez de démarrer un processus et que vous souhaitez utiliser son handle de fenêtre principal, envisagez d’utiliser la WaitForInputIdle méthode pour permettre au processus de terminer le démarrage, en veillant à ce que le handle de fenêtre principale ait été créé. Sinon, une exception est levée.

S’applique à

Voir aussi