PictureBox.LoadProgressChanged イベント

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

非同期のイメージ読み込み操作の進行状況が変化したときに発生します。

public:
 event System::ComponentModel::ProgressChangedEventHandler ^ LoadProgressChanged;

public event System.ComponentModel.ProgressChangedEventHandler LoadProgressChanged;

member this.LoadProgressChanged : System.ComponentModel.ProgressChangedEventHandler 

Public Custom Event LoadProgressChanged As ProgressChangedEventHandler 

イベントの種類

ProgressChangedEventHandler

例

次のコード例は、LoadProgressChanged イベントの処理方法を示したものです。 この例を実行するには、次のコードを、名前付き 、 という名前の 、 Button という名前startLoadButtonpictureBox1の を含む PictureBox Windows フォームにProgressBarprogressBar1貼り付けます。 メソッドがボタンの startLoadButton_Click イベントに Click 関連付けられていることを確認し、メソッドが pictureBox1_LoadProgressChanged のイベントに LoadProgressChanged 関連付けられていることを確認します pictureBox1。 イメージ・ファイル・パスは、システム上で有効なパスに変更する必要があります。

private void startButton_Click(object sender, EventArgs e)
{
    // Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = false;

    // Load the image asynchronously.
    pictureBox1.LoadAsync(@"http://localhost/print.gif");
}

Private Sub startLoadButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles startLoadButton.Click

    ' Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = False

    ' Load the image asynchronously.
    pictureBox1.LoadAsync("http://localhost/print.gif")

End Sub

void pictureBox1_LoadProgressChanged(object sender, 
    ProgressChangedEventArgs e)
{
    progressBar1.Value = e.ProgressPercentage;
}

Private Sub pictureBox1_LoadProgressChanged(ByVal sender As Object, _
    ByVal e As ProgressChangedEventArgs) _
    Handles pictureBox1.LoadProgressChanged

    progressBar1.Value = e.ProgressPercentage

End Sub

注釈

は LoadProgressChanged 、いずれかのメソッドを使用して LoadAsync イメージが非同期に読み込まれる場合にのみ発生します。 イメージの読み込みの進行状況の割合は、 の プロパティを使用して ProgressPercentage 報告されます ProgressChangedEventArgs。

LoadProgressChangedまたは同様のコントロールで非同期のイメージ読み込み操作の進行状況を反映する場合は、 をProgressBar処理します。 進行状況の値を ProgressPercentage 更新するには、 ProgressChangedEventArgs の プロパティを使用します。

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