PictureBox.LoadCompleted Zdarzenie

Definicja

Namespace:

System.Windows.Forms

Montaż:

System.Windows.Forms.dll

Źródło:

PictureBox.cs

Występuje, gdy operacja asynchronicznego ładowania obrazów została ukończona, została anulowana lub zgłosiła wyjątek.

public:
 event System::ComponentModel::AsyncCompletedEventHandler ^ LoadCompleted;

public event System.ComponentModel.AsyncCompletedEventHandler? LoadCompleted;

member this.LoadCompleted : System.ComponentModel.AsyncCompletedEventHandler 

Public Custom Event LoadCompleted As AsyncCompletedEventHandler 

Typ wydarzenia

AsyncCompletedEventHandler

Przykłady

W poniższym przykładzie kodu pokazano użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie LoadCompleted zdarzenia. Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie, i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub często występujących zdarzeń, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączenie go do wielowierszowego TextBoxelementu .

Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu PictureBox o nazwie PictureBox1. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem 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

Uwagi

Występuje LoadCompleted tylko wtedy, gdy obraz jest ładowany asynchronicznie przy użyciu jednej z LoadAsync metod i WaitOnLoad ma wartość false. Jeśli ładowanie obrazów zostanie anulowane przez wywołanie CancelAsync metody , Cancelled właściwość AsyncCompletedEventArgs obiektu zostanie ustawiona na truewartość . Jeśli podczas procesu ładowania wystąpi wyjątek lub błąd, zostanie przechwycony, a Error właściwość obiektu AsyncCompletedEventArgs będzie zawierać informacje o wyjątku.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.