PictureBox.WaitOnLoad Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

PictureBox.cs

Obtém ou define um valor que indica se uma imagem é carregada de forma síncrona.

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

Valor da propriedade

Boolean

true se uma operação de carregamento de imagem for concluída de forma síncrona; caso contrário, false. O padrão é false.

Exemplos

O exemplo de código a seguir demonstra como usar a WaitOnLoad propriedade . Para executar este exemplo, cole o código a seguir em um Formulário do Windows que contém um PictureBox nomeado pictureBox1 e um Button chamado startLoadButton. Verifique se o Click evento para o botão está associado ao startLoadButton_Click método neste exemplo. Você deve alterar o caminho do arquivo de imagem para um que seja válido em seu 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

Comentários

Definir a WaitOnLoad propriedade como true significa que a imagem é carregada de forma síncrona. Isso faz com que a interface do usuário seja bloqueada de outras entradas até que a imagem seja carregada. Quando WaitOnLoad é false (o padrão) e o LoadAsync método é usado para carregar a imagem, a InitialImage imagem é exibida quando a imagem especificada é carregada e o usuário pode interagir com a interface durante o processo de carga.