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

Definição

Ocorre quando o progresso de uma operação assíncrona de carregamento de imagem é alterado.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 

Exemplos

O exemplo de código a seguir demonstra como manipular LoadProgressChanged o evento.The following code example demonstrates how to handle the LoadProgressChanged event. Para executar este exemplo, Cole o código a seguir em um formulário do Windows que PictureBox contenha um Button nome startLoadButtonnomeado pictureBox1, um ProgressBar nomeado progressBar1e um nomeado.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. startLoadButton_Click Verifique se o método está associado pictureBox1_LoadProgressChanged Click ao evento para o botão e se o método está associado LoadProgressChanged ao evento 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. Você deve alterar o caminho do arquivo de imagem para um caminho que seja válido em seu 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 

Comentários

O LoadProgressChanged ocorre somente quando a imagem é carregada de forma assíncrona usando um LoadAsync dos métodos.The LoadProgressChanged occurs only when the image is loaded asynchronously by using one of the LoadAsync methods. A porcentagem de progresso do carregamento da imagem é relatada com ProgressPercentage a ProgressChangedEventArgsPropriedade do.The progress percentage of the image load is reported with the ProgressPercentage property of the ProgressChangedEventArgs.

Manipule o LoadProgressChanged se você quiser refletir o progresso de uma operação assíncrona de carregamento de imagem em ProgressBar um controle ou semelhante.Handle the LoadProgressChanged if you want to reflect the progress of an asynchronous image-loading operation in a ProgressBar or similar control. Use a ProgressPercentage propriedade ProgressChangedEventArgs do para atualizar o valor de progresso.Use the ProgressPercentage property of the ProgressChangedEventArgs to update the progress value.

Para obter mais informações sobre como manipular eventos, consulte manipulando e gerando eventos.For more information about handling events, see Handling and Raising Events.

Aplica-se a