PictureBox.LoadCompleted Событие

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

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

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

Тип события

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 объекта будет содержать сведения об исключении.

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

Применяется к