PictureBox.LoadCompleted Событие

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Происходит при завершении операции асинхронной загрузки изображения, ее отмене или возникновении исключения.

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

public event System.ComponentModel.AsyncCompletedEventHandler LoadCompleted;

member this.LoadCompleted : System.ComponentModel.AsyncCompletedEventHandler 

Public Custom Event LoadCompleted As AsyncCompletedEventHandler 

Тип события

AsyncCompletedEventHandler

Примеры

В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении LoadCompleted события. Этот отчет поможет вам узнать, когда происходит событие, и может помочь в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить MessageBox.ShowConsole.WriteLine сообщение на или добавить его в многостроочный TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа PictureBox с именем PictureBox1. Затем убедитесь, что обработчик событий связан с событием 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

Комментарии

Возникает LoadCompleted , только если образ загружается асинхронно с помощью одного из LoadAsync методов и WaitOnLoad имеет значение false. Если загрузка образа отменена путем вызова CancelAsync метода, Cancelled свойству AsyncCompletedEventArgs объекта будет присвоено значение true. Если во время процесса загрузки возникает исключение или ошибка, они будут перехвачены, а Error свойство AsyncCompletedEventArgs объекта будет содержать сведения об исключении.

Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.