PictureBox.LoadProgressChanged イベント

.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

C#

public event ProgressChangedEventHandler LoadProgressChanged

C++

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

J#

/** @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 

C#

        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;
        }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PictureBox クラス
PictureBox メンバ
System.Windows.Forms 名前空間