PictureBox.LoadCompleted Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica quando un'operazione di caricamento asincrono di un'immagine è stata completata, è stata annullata oppure ha generato un'eccezione.

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 evento

AsyncCompletedEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento LoadCompleted . Questo report consente di apprendere quando si verifica l'evento e può essere utile per il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire MessageBox.Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo PictureBox denominata PictureBox1. Assicurarsi quindi che il gestore eventi sia associato all'evento LoadCompleted .

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

Commenti

Si LoadCompleted verifica solo quando l'immagine viene caricata in modo asincrono usando uno dei LoadAsync metodi e WaitOnLoad è false. Se il caricamento dell'immagine viene annullato chiamando il CancelAsync metodo la Cancelled proprietà di AsyncCompletedEventArgs verrà impostata su true. Se si verifica un'eccezione o un errore durante il processo di caricamento, verrà intercettata e la Error proprietà di AsyncCompletedEventArgs conterrà le informazioni sull'eccezione.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.