PictureBox.LoadProgressChanged Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

PictureBox.cs

Se produit lorsque la progression d’une opération de chargement d’image asynchrone a changé.

public:
 event System::ComponentModel::ProgressChangedEventHandler ^ LoadProgressChanged;

public event System.ComponentModel.ProgressChangedEventHandler? LoadProgressChanged;

member this.LoadProgressChanged : System.ComponentModel.ProgressChangedEventHandler 

Public Custom Event LoadProgressChanged As ProgressChangedEventHandler 

Type d'événement

ProgressChangedEventHandler

Exemples

L’exemple de code suivant montre comment gérer l’événement LoadProgressChanged . Pour exécuter cet exemple, collez le code suivant dans un Windows Form qui contient un nompictureBox1, un ButtonPictureBox nommé startLoadButtonet un ProgressBar nommé progressBar1. Assurez-vous que la startLoadButton_Click méthode est associée à l’événement Click pour le bouton et que la pictureBox1_LoadProgressChanged méthode est associée à l’événement LoadProgressChanged pour pictureBox1. Vous devez modifier le chemin d’accès du fichier image à un chemin d’accès valide sur votre système.

private void startButton_Click(object sender, EventArgs e)
{
    // Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = false;

    // Load the image asynchronously.
    pictureBox1.LoadAsync(@"http://localhost/print.gif");
}

Private Sub startLoadButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles startLoadButton.Click

    ' Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = False

    ' Load the image asynchronously.
    pictureBox1.LoadAsync("http://localhost/print.gif")

End Sub

void pictureBox1_LoadProgressChanged(object sender, 
    ProgressChangedEventArgs e)
{
    progressBar1.Value = e.ProgressPercentage;
}

Private Sub pictureBox1_LoadProgressChanged(ByVal sender As Object, _
    ByVal e As ProgressChangedEventArgs) _
    Handles pictureBox1.LoadProgressChanged

    progressBar1.Value = e.ProgressPercentage

End Sub

Remarques

L’événement LoadProgressChanged se produit uniquement lorsque l’image est chargée de manière asynchrone à l’aide de l’une LoadAsync des méthodes. Le pourcentage de progression du chargement de l’image est signalé avec la ProgressPercentage propriété du ProgressChangedEventArgs.

Gérez la LoadProgressChanged valeur si vous souhaitez refléter la progression d’une opération de chargement d’images asynchrone dans un ProgressBar contrôle ou similaire. Utilisez la ProgressPercentage propriété de l’élément ProgressChangedEventArgs pour mettre à jour la valeur de progression.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.