PictureBox.LoadCompleted Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando a operação assíncrona de carregamento de imagem for concluída, cancelada ou gerar uma exceção.
public:
event System::ComponentModel::AsyncCompletedEventHandler ^ LoadCompleted;public event System.ComponentModel.AsyncCompletedEventHandler LoadCompleted;public event System.ComponentModel.AsyncCompletedEventHandler? LoadCompleted;member this.LoadCompleted : System.ComponentModel.AsyncCompletedEventHandler Public Custom Event LoadCompleted As AsyncCompletedEventHandler Tipo de evento
Exemplos
O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do LoadCompleted evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo PictureBox chamada PictureBox1. Em seguida, verifique se o manipulador de eventos está associado ao LoadCompleted evento.
private void PictureBox1_LoadCompleted(Object sender, AsyncCompletedEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Cancelled", e.Cancelled );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Error", e.Error );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "UserState", e.UserState );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "LoadCompleted Event" );
}
Private Sub PictureBox1_LoadCompleted(sender as Object, e as AsyncCompletedEventArgs) _
Handles PictureBox1.LoadCompleted
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "Cancelled", e.Cancelled)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Error", e.Error)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "UserState", e.UserState)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"LoadCompleted Event")
End Sub
Comentários
O LoadCompleted ocorre somente quando a imagem é carregada de forma assíncrona usando um dos LoadAsync métodos e WaitOnLoad é false. Se a carga de imagem for cancelada chamando o CancelAsync método , a Cancelled propriedade do AsyncCompletedEventArgs será definida como true. Se ocorrer uma exceção ou erro durante o processo de carga, ela será capturada e a Error propriedade do conterá as informações de AsyncCompletedEventArgs exceção.
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.
