Método My.Application.DoEvents

Artigo
08/25/2010

Processa todas as mensagens do Windows que estão atualmente na fial de mensagens.

' Usage
My.Application.DoEvents()
' Declaration
Public Sub DoEvents()

Comentários

O método My.Application.DoEvents permite que seu aplicativo manipule outros eventos que podem ser erguidos enquanto seu código é executado.O método My.Application.DoEvents possui o mesmo comportamento que o método DoEvents.

Quando você executa um aplicativo Windows Forms, ele cria um novo formulário, que então aguarda o eventos serem manipulados.Cada vez que o formulário manipula um evento, como um clique de botão, ele processa todo o código associado com aquele evento.Todos os outros eventos aguardam na fila.Enquanto o seu código manipula o evento, seu aplicativo não responde.Por exemplo, a janela não é repintada se outra janela é arrastada por cima.

Se você chamar My.Application.DoEvents no seu código, seu aplicativo pode manipular os outros eventos.Por exemplo, se seu código adiciona dados ao ListBox num loop, e depois de cada passo do loop ele chama My.Application.DoEvents, seu formulário é repintado quando outra janela é arrastada sobre ele.Se você remover My.Application.DoEvents do seu código, seu formulário não irá ser repintado até que o evento de clique manipulador do botão é terminado de executar.

Tipicamente, você usa este método num loop para processar mensagens.

Observação:
O My.Application.DoEvents método não processa eventos exatamente da mesma forma sistema autônomo o formulário. Use multithreading para tornar o formulário diretamente manipular os eventos.Para obter mais informações, consulte Multithreading no Visual Basic.

Cuidado:
Se chama um método que manipula um evento de interface do usuário a My.Application.DoEvents método, o método pode ser inseridos novamente antes de terminar. Isso pode acontecer porque o método My.Application.DoEvents processa mensagens do Windows, e mensagens do Windows podem elevar eventos.

Tarefas

A tabela seguinte lista um exemplo de tarefa envolvendo o método My.Application.DoEvents.

Para	Consulte
Permitir que um formulário responder a interface do usuário entrado enquanto ocupado	Demonstra Passo a passo: Tratamento de eventos

Exemplo

Este exemplo usa o método My.Application.DoEvents Para permitir que o interface do usuário para TextBox1 para atualizar.

Private Sub TestDoEvents()
    For i As Integer = 0 To 10000
        TextBox1.Text = i.ToString
        My.Application.DoEvents()
    Next
End Sub

Esse código deve estar em um formulário que tenha um TextBox1 componente com a propriedade Text.

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Não
Aplicativo de Console	Não
Biblioteca de Controle do Windows	Não
Biblioteca de Controle da Web	Não
Serviço do Windows	Não
Site	Não

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
UIPermission	Controla as permissões relacionadas às interfaces com o usuário e área de transferência.Enumeração associada: AllWindows.