PictureBox.LoadProgressChanged PictureBox.LoadProgressChanged PictureBox.LoadProgressChanged PictureBox.LoadProgressChanged Event

Définition

Se produit lorsque la progression d'une opération de chargement d'image asynchrone a été modifiée.Occurs when the progress of an asynchronous image-loading operation has changed.

public:
 event System::ComponentModel::ProgressChangedEventHandler ^ LoadProgressChanged;
public event System.ComponentModel.ProgressChangedEventHandler LoadProgressChanged;
member this.LoadProgressChanged : System.ComponentModel.ProgressChangedEventHandler 
Public Custom Event LoadProgressChanged As ProgressChangedEventHandler 

Exemples

L’exemple de code suivant montre comment gérer l' LoadProgressChanged événement.The following code example demonstrates how to handle the LoadProgressChanged event. Pour exécuter cet exemple, collez le code suivant dans un Windows Form qui contient PictureBox un pictureBox1nommé, Button un startLoadButtonnommé et un ProgressBar nommé progressBar1.To run this example, paste the following code into a Windows Form that contains a PictureBox named pictureBox1, a Button named startLoadButton, and a ProgressBar named progressBar1. Assurez-vous startLoadButton_Click que la méthode est associée Click à l’événement pour le bouton pictureBox1_LoadProgressChanged et que la méthode est LoadProgressChanged associée à pictureBox1l’événement pour.Make sure that the startLoadButton_Click method is associated with the Click event for the button and the pictureBox1_LoadProgressChanged method is associated with the LoadProgressChanged event for pictureBox1. Vous devez remplacer le chemin d’accès du fichier image par un chemin d’accès valide sur votre système.You must change the image file path to a path that is valid on your system.

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

Se produit uniquement lorsque l’image est chargée de façon asynchrone à l’aide LoadAsync de l’une des méthodes. LoadProgressChangedThe LoadProgressChanged occurs only when the image is loaded asynchronously by using one of the LoadAsync methods. Le pourcentage de progression du chargement de l’image est signalé ProgressPercentage avec la propriété ProgressChangedEventArgsde.The progress percentage of the image load is reported with the ProgressPercentage property of the ProgressChangedEventArgs.

Gérez le LoadProgressChanged si vous souhaitez refléter la progression d’une opération asynchrone de chargement d’images dans un ProgressBar contrôle ou similaire.Handle the LoadProgressChanged if you want to reflect the progress of an asynchronous image-loading operation in a ProgressBar or similar control. Utilisez la ProgressPercentage propriété ProgressChangedEventArgs du pour mettre à jour la valeur de progression.Use the ProgressPercentage property of the ProgressChangedEventArgs to update the progress value.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à