PictureBox.LoadProgressChanged Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ocorre quando o progresso de uma operação assíncrona de carregamento de imagem é alterado.

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

public event System.ComponentModel.ProgressChangedEventHandler LoadProgressChanged;

member this.LoadProgressChanged : System.ComponentModel.ProgressChangedEventHandler 

Public Custom Event LoadProgressChanged As ProgressChangedEventHandler 

Tipo de evento

ProgressChangedEventHandler

Exemplos

O exemplo de código a seguir demonstra como lidar com o LoadProgressChanged evento. Para executar este exemplo, cole o código a seguir em um Formulário do Windows que contém um PictureBox chamado pictureBox1, um Button chamado startLoadButtone um ProgressBar chamado progressBar1. Verifique se o startLoadButton_Click método está associado ao Click evento para o botão e se o pictureBox1_LoadProgressChanged método está associado ao LoadProgressChanged evento para pictureBox1. Você deve alterar o caminho do arquivo de imagem para um caminho válido em seu sistema.

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 dos LoadAsync métodos. O percentual de progresso da carga de imagem é relatado com a ProgressPercentage propriedade do ProgressChangedEventArgs.

Manipule o LoadProgressChanged se você quiser refletir o progresso de uma operação de carregamento de imagem assíncrona em um ProgressBar controle ou semelhante. Use a ProgressPercentage propriedade do ProgressChangedEventArgs para atualizar o valor de progresso.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.