Partager via


Process.MainWindowHandle Propriété

Définition

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

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

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 main 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 afin d’obtenir le plus à jour main handle de fenêtre s’il a changé. En général, étant donné que le handle de fenêtre est mis en cache, utilisez Refresh à l’avance pour garantir 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.

Une fenêtre de main est associée à un processus uniquement si le processus dispose d’une interface graphique. Si le processus associé n’a pas de fenêtre main, 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 s’affichent 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 main, envisagez d’utiliser la WaitForInputIdle méthode pour permettre au processus de démarrer, en vous assurant que le main handle de fenêtre a été créé. Sinon, une exception est levée.

S’applique à

Voir aussi