Application.DoEvents Metoda

Definicja

Przetwarza wszystkie komunikaty systemu Windows aktualnie w kolejce komunikatów.

C#
public static void DoEvents();

Przykłady

Poniższy przykład kodu przedstawia użycie DoEvents metody . Po uruchomieniu przykładu użytkownik może wybrać pliki graficzne z pliku OpenFileDialog. Wybrane pliki są wyświetlane w formularzu. Metoda DoEvents wymusza powtórzenia formularza dla każdego otwartego pliku graficznego. Aby uruchomić ten przykład, wklej następujący kod w formularzu zawierającym nazwany PictureBoxPictureBox1, nazwany OpenFileDialog i przycisk o nazwie OpenFileDialog1fileButton. Wywołaj InitializePictureBox metody i InitializeOpenFileDialog z konstruktora lub Load metody formularza.

Uwaga

W programie Visual Studio, jeśli dodasz element OpenFileDialog do formularza przy użyciu operacji przeciągania, musisz zmodyfikować następującą InitializeOpenFileDialog metodę, usuwając wiersz, który tworzy nowe wystąpienie OpenFileDialogklasy .

Przykład wymaga również, aby Control.Click zdarzenie kontrolki Button i FileOk zdarzenie OpenFileDialog obiektu było połączone z procedurami obsługi zdarzeń zdefiniowanymi w przykładzie. Po uruchomieniu przykładu wyświetl okno dialogowe, klikając przycisk .

C#
private void InitializePictureBox()
{
    this.pictureBox1 = new System.Windows.Forms.PictureBox();
    this.pictureBox1.BorderStyle = 
        System.Windows.Forms.BorderStyle.FixedSingle;
    this.pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
    this.pictureBox1.Location = new System.Drawing.Point(72, 112);
    this.pictureBox1.Name = "pictureBox1";
    this.pictureBox1.Size = new System.Drawing.Size(160, 136);
    this.pictureBox1.TabIndex = 6;
    this.pictureBox1.TabStop = false;
}

private void InitializeOpenFileDialog()
{
    this.openFileDialog1 = new System.Windows.Forms.OpenFileDialog();

    // Set the file dialog to filter for graphics files.
    this.openFileDialog1.Filter = 
        "Images (*.BMP;*.JPG;*.GIF)|*.BMP;*.JPG;*.GIF|" + 
        "All files (*.*)|*.*";

    // Allow the user to select multiple images.
    this.openFileDialog1.Multiselect = true;
    this.openFileDialog1.Title = "My Image Browser";
}

private void fileButton_Click(System.Object sender, System.EventArgs e)
{
    openFileDialog1.ShowDialog();
}


// This method handles the FileOK event.  It opens each file 
// selected and loads the image from a stream into pictureBox1.
private void openFileDialog1_FileOk(object sender, 
    System.ComponentModel.CancelEventArgs e)
{

    this.Activate();
     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.        
    foreach (string file in files )
    {
        System.IO.FileInfo fileInfo = new System.IO.FileInfo(file);
        System.IO.FileStream 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);
    }
    pictureBox1.Image = null;
}

Uwagi

Po uruchomieniu formularza systemu Windows tworzy on nowy formularz, który następnie oczekuje na obsługę zdarzeń. Za każdym razem, gdy formularz obsługuje zdarzenie, przetwarza cały kod skojarzony z tym zdarzeniem. Wszystkie inne zdarzenia czekają w kolejce. Podczas gdy kod obsługuje zdarzenie, aplikacja nie odpowiada. Na przykład okno nie zostanie ponownie wyświetlone, jeśli w górnej części zostanie przeciągnięte inne okno.

W przypadku wywołania DoEvents w kodzie aplikacja może obsługiwać inne zdarzenia. Jeśli na przykład masz formularz, który dodaje dane do ListBox kodu i dodaje DoEvents je do kodu, po przeciągnięciu na niego innego okna. Jeśli usuniesz DoEvents plik z kodu, formularz nie zostanie ponownie wyświetlony, dopóki procedura obsługi zdarzeń kliknięcia przycisku nie zostanie zakończona. Aby uzyskać więcej informacji na temat obsługi komunikatów, zobacz Dane wejściowe użytkownika w Windows Forms.

W przeciwieństwie do języka Visual Basic 6.0 DoEvents metoda nie wywołuje Thread.Sleep metody .

Zazwyczaj ta metoda jest używana w pętli do przetwarzania komunikatów.

Przestroga

Wywołanie tej metody powoduje wstrzymanie bieżącego wątku podczas przetwarzania wszystkich komunikatów okna oczekiwania. Jeśli komunikat powoduje wyzwolenie zdarzenia, mogą zostać wykonane inne obszary kodu aplikacji. Może to spowodować, że aplikacja będzie wykazywać nieoczekiwane zachowania, które są trudne do debugowania. Jeśli wykonujesz operacje lub obliczenia, które zajmują dużo czasu, często zaleca się wykonywanie tych operacji na nowym wątku. Aby uzyskać więcej informacji na temat programowania asynchronicznego, zobacz Asynchronous Programming Model (APM).

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Zobacz też