Processes all Windows messages currently in the message queue.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
When you run a Windows Form, it creates the new form, which then waits for events to handle. Each time the form handles an event, it processes all the code associated with that event. All other events wait in the queue. While your code handles the event, your application does not respond. For example, the window does not repaint if another window is dragged on top.
If you call in your code, your application can handle the other events. For example, if you have a form that adds data to a ListBox and add to your code, your form repaints when another window is dragged over it. If you remove from your code, your form will not repaint until the click event handler of the button is finished executing. For more information on messaging, see User Input in Windows Forms.
Unlike Visual Basic 6.0, the method does not call the Thread.Sleep method.
Typically, you use this method in a loop to process messages.
Calling this method causes the current thread to be suspended while all waiting window messages are processed. If a message causes an event to be triggered, then other areas of your application code may execute. This can cause your application to exhibit unexpected behaviors that are difficult to debug. If you perform operations or computations that take a long time, it is often preferable to perform those operations on a new thread. For more information about asynchronous programming, see Asynchronous Programming Model (APM).
The following code example demonstrates using the method. When the example runs, a user can select graphics files from an OpenFileDialog. The selected files are displayed in the form. The method forces a repaint of the form for each graphics file opened. To run this example, paste the following code in a form containing a PictureBox named PictureBox1, an OpenFileDialog named OpenFileDialog1, and a button named fileButton. Call the InitializePictureBox and InitializeOpenFileDialog methods from the form's constructor or Load method.
In Visual Studio, if you add an OpenFileDialog to your form by using a drag operation, you will have to modify the following InitializeOpenFileDialog method by removing the line that creates a new instance of OpenFileDialog.
The example also requires that the Control.Click event of the Button control and the FileOk event of the OpenFileDialog are connected to the event handlers defined in the example. When the example is running, display the dialog box by clicking the button.
Private Sub InitializePictureBox() Me.PictureBox1 = New System.Windows.Forms.PictureBox Me.PictureBox1.BorderStyle = _ System.Windows.Forms.BorderStyle.FixedSingle Me.PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage Me.PictureBox1.Location = New System.Drawing.Point(72, 112) Me.PictureBox1.Name = "PictureBox1" Me.PictureBox1.Size = New System.Drawing.Size(160, 136) Me.PictureBox1.TabStop = False End Sub Private Sub InitializeOpenFileDialog() Me.OpenFileDialog1 = New System.Windows.Forms.OpenFileDialog ' Set the file dialog to filter for graphics files. Me.OpenFileDialog1.Filter = _ "Images (*.BMP;*.JPG;*.GIF)|*.BMP;*.JPG;*.GIF|All files (*.*)|*.*" ' Allow the user to select multiple images. Me.OpenFileDialog1.Multiselect = True Me.OpenFileDialog1.Title = "My Image Browser" End Sub Private Sub fileButton_Click(ByVal sender As System.Object, _ ByVal e As System.EventArgs) Handles FileButton.Click OpenFileDialog1.ShowDialog() End Sub ' This method handles the FileOK event. It opens each file ' selected and loads the image from a stream into PictureBox1. Private Sub OpenFileDialog1_FileOk(ByVal sender As Object, _ ByVal e As System.ComponentModel.CancelEventArgs) _ Handles OpenFileDialog1.FileOk Me.Activate() Dim file, files() As String files = OpenFileDialog1.FileNames ' Open each file and display the image in PictureBox1. ' Call Application.DoEvents to force a repaint after each ' file is read. For Each file In files Dim fileInfo As System.IO.FileInfo = New System.IO.FileInfo(file) Dim fileStream As System.IO.FileStream = fileInfo.OpenRead() PictureBox1.Image = System.Drawing.Image.FromStream(fileStream) Application.DoEvents() fileStream.Close() ' Call Sleep so the picture is briefly displayed, 'which will create a slide-show effect. System.Threading.Thread.Sleep(2000) Next PictureBox1.Image = Nothing End Sub
To run this example paste the following code in a form containing a PictureBox named PictureBox1, an OpenFileDialog named OpenFileDialog1, and a button named fileButton. Call the InitializePictureBox and InitializeOpenFileDialog methods from the form's constructor or Load method. When the example is running, display the dialog by clicking the button.
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.