PictureBox.WaitOnLoad Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wartość wskazującą, czy obraz jest ładowany synchronicznie.

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

Wartość właściwości

Boolean

true jeśli operacja ładowania obrazów jest wykonywana synchronicznie; w przeciwnym razie , false. Wartość domyślna to false.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać WaitOnLoad właściwości . Aby uruchomić ten przykład, wklej następujący kod w formularzu systemu Windows zawierającym PictureBox nazwę pictureBox1 i Button nazwę startLoadButton. Upewnij się, że Click zdarzenie przycisku jest skojarzone z startLoadButton_Click metodą w tym przykładzie. Należy zmienić ścieżkę pliku obrazu na prawidłową w systemie.

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

Uwagi

WaitOnLoad Ustawienie właściwości na true wartość oznacza, że obraz jest ładowany synchronicznie. Powoduje to zablokowanie interfejsu użytkownika przed innymi danymi wejściowymi do momentu załadowania obrazu. Gdy WaitOnLoad jest false (wartość domyślna), a LoadAsync metoda jest używana do ładowania obrazu, InitialImage obraz jest wyświetlany po załadowaniu określonego obrazu, a użytkownik może wchodzić w interakcję z interfejsem podczas procesu ładowania.