PictureBox.LoadProgressChanged Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica quando lo stato di un'operazione asincrona di caricamento dell'immagine è cambiato.

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

public event System.ComponentModel.ProgressChangedEventHandler LoadProgressChanged;

member this.LoadProgressChanged : System.ComponentModel.ProgressChangedEventHandler 

Public Custom Event LoadProgressChanged As ProgressChangedEventHandler 

Tipo evento

ProgressChangedEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato come gestire l'evento LoadProgressChanged . Per eseguire questo esempio, incollare il codice seguente in un Windows Form contenente un PictureBox denominato pictureBox1, un ButtonstartLoadButtondenominato e un ProgressBar denominato progressBar1. Assicurarsi che il startLoadButton_Click metodo sia associato all'evento Click per il pulsante e che il pictureBox1_LoadProgressChanged metodo sia associato all'evento LoadProgressChanged per pictureBox1. È necessario modificare il percorso del file di immagine in un percorso valido nel sistema.

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

Commenti

Si LoadProgressChanged verifica solo quando l'immagine viene caricata in modo asincrono usando uno dei LoadAsync metodi . La percentuale di avanzamento del caricamento dell'immagine viene segnalata con la ProgressPercentage proprietà dell'oggetto ProgressChangedEventArgs.

Gestire se LoadProgressChanged si desidera riflettere lo stato di avanzamento di un'operazione di caricamento asincrono delle immagini in un ProgressBar controllo o simile. Utilizzare la ProgressPercentage proprietà di ProgressChangedEventArgs per aggiornare il valore di stato.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.