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 事件。 若要运行此示例，请将以下代码粘贴到 Windows PictureBox 窗体中，其中包含名为 pictureBox1的 、Button名为 startLoadButton的 和 ProgressBar 。progressBar1 确保 方法 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才会发生 。 使用 的 属性ProgressChangedEventArgs报告ProgressPercentage图像加载的进度百分比。

LoadProgressChanged如果要在 或类似控件中反映异步图像加载操作的进度，ProgressBar请处理 。 ProgressPercentage使用 的 ProgressChangedEventArgs 属性更新进度值。

有关处理事件的详细信息，请参阅 处理和引发事件。