PictureBox.LoadProgressChanged イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

PictureBox.LoadProgressChanged イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event LoadProgressChanged As
 ProgressChangedEventHandler

Visual Basic (使用法)

Dim instance As PictureBox
Dim handler As ProgressChangedEventHandler

AddHandler instance.LoadProgressChanged, handler

public event ProgressChangedEventHandler LoadProgressChanged

C++

public:
event ProgressChangedEventHandler^ LoadProgressChanged {
    void add (ProgressChangedEventHandler^ value);
    void remove (ProgressChangedEventHandler^ value);
}

/** @event */
public void add_LoadProgressChanged (ProgressChangedEventHandler
 value)

/** @event */
public void remove_LoadProgressChanged (ProgressChangedEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

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

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

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

使用例

LoadProgressChanged イベントを処理する方法を次のコード例に示します。この例を実行するには、pictureBox1 という名前の PictureBox、startLoadButton という名前の Button、および progressBar1 という名前の ProgressBar が配置されている Windows フォームに次のコードを貼り付けます。startLoadButton_Click メソッドにボタンの Click イベントが関連付けられ、pictureBox1_LoadProgressChanged メソッドに pictureBox1 の LoadProgressChanged イベントが関連付けられていることを確認してください。イメージファイルのパスは、システム内の有効なパスに変更する必要があります。

Visual Basic

    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
    
<br /><span space="preserve">...</span><br
 />    Private Sub pictureBox1_LoadProgressChanged(ByVal
 sender As Object, _
        ByVal e As ProgressChangedEventArgs)
 _
        Handles pictureBox1.LoadProgressChanged

        progressBar1.Value = e.ProgressPercentage

    End Sub

        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");
        }
<br /><span space="preserve">...</span><br /> 
       void pictureBox1_LoadProgressChanged(object sender, 
            ProgressChangedEventArgs e)
        {
            progressBar1.Value = e.ProgressPercentage;
        }