Process.MainWindowHandle Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient le handle de fenêtre de la fenêtre principale du processus associé.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrValeur de propriété
nativeint
Handle de fenêtre généré par le système de la fenêtre principale du processus associé.
Exceptions
La MainWindowHandle valeur n’est pas définie, car le processus a quitté.
Vous essayez d’accéder à la MainWindowHandle propriété pour un processus en cours d’exécution sur un ordinateur distant. Cette propriété est disponible uniquement pour les processus qui s’exécutent 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 manière 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 sa poignée de fenêtre principale, envisagez d’utiliser la WaitForInputIdle méthode pour permettre au processus de terminer le démarrage, en vous assurant que le handle de fenêtre principal a été créé. Sinon, une exception est levée.
