PictureBox.LoadCompleted Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

K tomuto problému dochází při dokončení asynchronní operace načtení image, zrušení nebo vyvolání výjimky.

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

public event System.ComponentModel.AsyncCompletedEventHandler LoadCompleted;

member this.LoadCompleted : System.ComponentModel.AsyncCompletedEventHandler 

Public Custom Event LoadCompleted As AsyncCompletedEventHandler 

Event Type

AsyncCompletedEventHandler

Příklady

Následující příklad kódu ukazuje použití tohoto člena. V příkladu obslužná rutina události hlásí výskyt LoadCompleted události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct s laděním. Pokud chcete hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy k víceřádkovému TextBoxobjektu .

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu PictureBox s názvem PictureBox1. Pak se ujistěte, že je obslužná rutina události přidružená k LoadCompleted události.

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

Poznámky

K LoadCompleted tomu dojde pouze v případě, že je image načtena asynchronně pomocí jedné z LoadAsync metod a WaitOnLoad je false. Pokud se načtení image zruší voláním CancelAsync metody, Cancelled vlastnost objektu AsyncCompletedEventArgs se nastaví na true. Pokud během procesu načítání dojde k výjimce nebo chybě, bude zachycena a Error vlastnost AsyncCompletedEventArgs bude obsahovat informace o výjimce.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.