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 発生を報告します。 このレポートは、イベントが発生したタイミングを知るのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を Console.WriteLine に置き換えるかMessageBox.Show、複数行TextBoxにメッセージを追加することを検討してください。

コード例を実行するには、 という名前PictureBox1の型PictureBoxのインスタンスを含むプロジェクトに貼り付けます。 次に、イベント ハンドラーが イベントに関連付けられていることを確認します 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場合にのみ発生します。 メソッドCancelledを呼び出CancelAsyncしてイメージの読み込みが取り消された場合、 の AsyncCompletedEventArgs プロパティは にtrue設定されます。 読み込みプロセス中に例外またはエラーが発生した場合は、例外がキャッチされ Error 、 の AsyncCompletedEventArgs プロパティに例外情報が含まれます。

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。

適用対象