Process.CloseMainWindow Méthode
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.
Ferme un processus possédant une interface utilisateur en envoyant un message de fermeture à sa fenêtre principale.
public:
bool CloseMainWindow();public bool CloseMainWindow ();member this.CloseMainWindow : unit -> boolPublic Function CloseMainWindow () As BooleanRetours
true si le message de fermeture a été correctement envoyé ; false si le processus associé ne possède pas de fenêtre principale ou si celle-ci est désactivée (par exemple si une boîte de dialogue modale est affichée).
Exceptions
Exemples
L’exemple suivant démarre une instance du Bloc-notes. Il récupère ensuite l’utilisation de la mémoire physique du processus associé à intervalles de 2 secondes pendant un maximum de 10 secondes. L’exemple détecte si le processus se termine avant l’expiration de 10 secondes. L’exemple ferme le processus s’il est toujours en cours d’exécution après 10 secondes.
#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
try
{
Process^ myProcess;
myProcess = Process::Start( "Notepad.exe" );
// Display physical memory usage 5 times at intervals of 2 seconds.
for ( int i = 0; i < 5; i++ )
{
if ( !myProcess->HasExited )
{
// Discard cached information about the process.
myProcess->Refresh();
// Print working set to console.
Console::WriteLine( "Physical Memory Usage : {0}", myProcess->WorkingSet.ToString() );
// Wait 2 seconds.
Thread::Sleep( 2000 );
}
else
{
break;
}
}
myProcess->CloseMainWindow();
// Free resources associated with process.
myProcess->Close();
}
catch ( Exception^ e )
{
Console::WriteLine( "The following exception was raised: " );
Console::WriteLine( e->Message );
}
}
using System;
using System.ComponentModel;
using System.Diagnostics;
using System.IO;
using System.Threading;
namespace ProcessSample
{
class MyProcessClass
{
public static void Main()
{
try
{
using (Process myProcess = Process.Start("Notepad.exe"))
{
// Display physical memory usage 5 times at intervals of 2 seconds.
for (int i = 0; i < 5; i++)
{
if (!myProcess.HasExited)
{
// Discard cached information about the process.
myProcess.Refresh();
// Print working set to console.
Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}");
// Wait 2 seconds.
Thread.Sleep(2000);
}
else
{
break;
}
}
// Close process by sending a close message to its main window.
myProcess.CloseMainWindow();
// Free resources associated with process.
myProcess.Close();
}
}
catch (Exception e) when (e is Win32Exception || e is FileNotFoundException)
{
Console.WriteLine("The following exception was raised: ");
Console.WriteLine(e.Message);
}
}
}
}
Imports System.ComponentModel
Imports System.Diagnostics
Imports System.IO
Imports System.Threading
Namespace Process_Sample
Class MyProcessClass
Public Shared Sub Main()
Try
Using myProcess = Process.Start("Notepad.exe")
' Display physical memory usage 5 times at intervals of 2 seconds.
Dim i As Integer
For i = 0 To 4
If Not myProcess.HasExited Then
' Discard cached information about the process.
myProcess.Refresh()
' Print working set to console.
Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}")
' Wait 2 seconds.
Thread.Sleep(2000)
Else
Exit For
End If
Next i
' Close process by sending a close message to its main window.
myProcess.CloseMainWindow()
' Free resources associated with process.
myProcess.Close()
End Using
Catch e As Exception When TypeOf e Is Win32Exception Or TypeOf e Is FileNotFoundException
Console.WriteLine("The following exception was raised: ")
Console.WriteLine(e.Message)
End Try
End Sub
End Class
End Namespace 'Process_Sample
Remarques
Lorsqu’un processus est en cours d’exécution, sa boucle de message est dans un état d’attente. La boucle de message s’exécute chaque fois qu’un message Windows est envoyé au processus par le système d’exploitation. L’appel CloseMainWindow envoie une demande de fermeture de la fenêtre main, qui, dans une application bien formée, ferme les fenêtres enfants et révoque toutes les boucles de message en cours d’exécution pour l’application. La demande de quitter le processus en appelant CloseMainWindow ne force pas l’application à quitter. L’application peut demander la vérification de l’utilisateur avant de quitter ou refuser de quitter. Pour forcer la fermeture de l’application, utilisez la Kill méthode . Le comportement de CloseMainWindow est identique à celui d’un utilisateur fermant la fenêtre main d’une application à l’aide du menu système. Par conséquent, la demande de quitter le processus en fermant la fenêtre main ne force pas l’application à quitter immédiatement.
Les données modifiées par le processus ou les ressources allouées au processus peuvent être perdues si vous appelez Kill. Kill provoque un arrêt anormal du processus et ne doit être utilisé que si nécessaire. CloseMainWindow permet une arrêt ordonné du processus et ferme toutes les fenêtres, ce qui est préférable pour les applications avec une interface. En cas CloseMainWindow d’échec, vous pouvez utiliser Kill pour arrêter le processus. Kill est le seul moyen d’arrêter des processus qui n’ont pas d’interfaces graphiques.
Vous pouvez appeler Kill et CloseMainWindow uniquement pour les processus qui s’exécutent sur l’ordinateur local. Vous ne pouvez pas provoquer la fermeture des processus sur les ordinateurs distants. Vous pouvez uniquement afficher les informations relatives aux processus exécutés sur des ordinateurs distants.
