PictureBox.WaitOnLoad Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un valore che indica se il caricamento di un'immagine è sincrono.

public:
 property bool WaitOnLoad { bool get(); void set(bool value); };

public bool WaitOnLoad { get; set; }

member this.WaitOnLoad : bool with get, set

Public Property WaitOnLoad As Boolean

Valore della proprietà

Boolean

true se l'operazione di caricamento di un'immagine viene completata in modo sincrono; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la WaitOnLoad proprietà . Per eseguire questo esempio, incollare il codice seguente in un Windows Form contenente un PictureBox oggetto denominato pictureBox1 e un Button denominato startLoadButton. Assicurarsi che l'evento Click per il pulsante sia associato al startLoadButton_Click metodo in questo esempio. È 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

Commenti

L'impostazione della WaitOnLoad proprietà su true indica che l'immagine viene caricata in modo sincrono. In questo modo, l'interfaccia utente viene bloccata da un altro input fino al caricamento dell'immagine. Quando WaitOnLoad è false (impostazione predefinita) e il LoadAsync metodo viene usato per caricare l'immagine, l'immagine InitialImage viene visualizzata quando viene caricata l'immagine specificata e l'utente può interagire con l'interfaccia durante il processo di caricamento.