PictureBox.CancelAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cancela uma carga de imagem assíncrona.
public:
void CancelAsync();
public void CancelAsync();
member this.CancelAsync : unit -> unit
Public Sub CancelAsync ()
Exemplos
O exemplo de código seguinte demonstra como usar o CancelAsync método. Para executar este exemplo, cole o seguinte código num Windows Form que contém um PictureBox chamado pictureBox1 e dois controlos Button chamados startLoadButton e cancelLoadButton. Certifique-se de que o Click evento dos botões está associado ao seu método de gestão de eventos neste exemplo. Deve alterar o caminho do ficheiro de imagem para um caminho 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
private void cancelButton_Click(object sender, EventArgs e)
{
pictureBox1.CancelAsync();
}
Private Sub cancelLoadButton_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles cancelLoadButton.Click
pictureBox1.CancelAsync()
End Sub
Observações
Uma PictureBox imagem é carregada de forma assíncrona quando a WaitOnLoad propriedade está false e o LoadAsync método é usado para carregar a imagem. Se uma carga for cancelada com o CancelAsync método o cancelamento é reportado elevando o LoadCompleted evento com a Cancelled propriedade do AsyncCompletedEventArgs conjunto para true.