PictureBox.WaitOnLoad Propriedade

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 de Propriedade

true se uma operação de carregamento de imagem for realizada de forma síncrona; caso contrário, false. A predefinição é false.

Exemplos

O exemplo de código seguinte demonstra como usar a WaitOnLoad propriedade. Para executar este exemplo, cole o seguinte código num formulário Windows que contenha um PictureBox chamado pictureBox1 e um Button chamado startLoadButton. Certifique-se de que o Click evento do botão está associado ao startLoadButton_Click método neste exemplo. Deve alterar o caminho do ficheiro de imagem para um que seja válido no 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

Observações

Definir a WaitOnLoad propriedade para true significa que a imagem é carregada de forma síncrona. Isto faz com que a interface do utilizador fique 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 utilizador pode interagir com a interface durante o processo de carregamento.