PictureBox.LoadProgressChanged Evento

Definición

Se produce cuando ha cambiado el progreso de una operación de carga de imagen asincrónica.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 

Ejemplos

En el ejemplo de código siguiente se muestra cómo controlar el evento LoadProgressChanged.The following code example demonstrates how to handle the LoadProgressChanged event. Para ejecutar este ejemplo, pegue el código siguiente en un formulario de Windows Forms que contenga una PictureBox denominada pictureBox1, una Button denominada startLoadButtony una ProgressBar denominada 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. Asegúrese de que el método startLoadButton_Click está asociado al evento Click para el botón y que el método pictureBox1_LoadProgressChanged está asociado al evento LoadProgressChanged para pictureBox1.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. Debe cambiar la ruta de acceso del archivo de imagen a una ruta de acceso válida en el sistema.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 

Comentarios

El LoadProgressChanged solo se produce cuando la imagen se carga de forma asincrónica utilizando uno de los métodos de LoadAsync.The LoadProgressChanged occurs only when the image is loaded asynchronously by using one of the LoadAsync methods. El porcentaje de progreso de la carga de la imagen se registra con la propiedad ProgressPercentage de la ProgressChangedEventArgs.The progress percentage of the image load is reported with the ProgressPercentage property of the ProgressChangedEventArgs.

Controle el LoadProgressChanged si desea reflejar el progreso de una operación de carga de imagen asincrónica en un control ProgressBar o similar.Handle the LoadProgressChanged if you want to reflect the progress of an asynchronous image-loading operation in a ProgressBar or similar control. Use la propiedad ProgressPercentage del ProgressChangedEventArgs para actualizar el valor de progreso.Use the ProgressPercentage property of the ProgressChangedEventArgs to update the progress value.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.For more information about handling events, see Handling and Raising Events.

Se aplica a