PictureBox.LoadCompleted Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при завершении операции асинхронной загрузки изображения, ее отмене или возникновении исключения.
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
Тип события
Примеры
В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении 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 объекта будет содержать сведения об исключении.
Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.