PictureBox.LoadCompleted Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando a operação de carregamento de imagem assíncrona é concluída, foi cancelada ou levantada como exceção.
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 seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do LoadCompleted evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo PictureBox chamada PictureBox1. Depois, certifique-se de que o gestor 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
Observações
Ocorre LoadCompleted apenas quando a imagem é carregada assíncrona usando um dos LoadAsync métodos, e WaitOnLoad é false. Se a image-load for cancelada ao chamar o CancelAsync método, a Cancelled propriedade de será AsyncCompletedEventArgs definida como true. Se ocorrer uma exceção ou erro durante o processo de carregamento, será apanhado e a Error propriedade de conterá AsyncCompletedEventArgs a informação da exceção.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.