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

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 LoadProgressChanged eventos.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 que contenga un PictureBox denominado pictureBox1, un Button denominado startLoadButtony un ProgressBar denominado 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 startLoadButton_Click método está asociado con el Click eventos para el botón y el pictureBox1_LoadProgressChanged método está asociado con el LoadProgressChanged eventos 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 es 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 se produce sólo cuando la imagen se carga asincrónicamente mediante uno de los LoadAsync métodos.The LoadProgressChanged occurs only when the image is loaded asynchronously by using one of the LoadAsync methods. Se notifica el porcentaje de progreso de la carga de la imagen con el ProgressPercentage propiedad de la ProgressChangedEventArgs.The progress percentage of the image load is reported with the ProgressPercentage property of the ProgressChangedEventArgs.

Controlar la LoadProgressChanged si desea reflejar el progreso de una operación asincrónica de carga de la imagen en un ProgressBar o un control 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 ProgressPercentage propiedad de la 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