Partilhar via

Eventos de controle (Windows Forms .NET)

  • Artigo

Os controles fornecem eventos que são gerados quando o usuário interage com o controle ou quando o estado do controle muda. Este artigo descreve os eventos comuns compartilhados pela maioria dos controles, eventos gerados pela interação do usuário e eventos exclusivos para controles específicos. Para obter mais informações sobre eventos no Windows Forms, consulte Visão geral de eventos e Manipulando e gerando eventos.

Para obter mais informações sobre como adicionar ou remover um manipulador de eventos, consulte Como lidar com um evento.

Eventos comuns

Controls fornece mais de 60 eventos através da classe base Control. Isso inclui o evento Paint, que faz com que um controle seja desenhado, eventos relacionados à exibição de uma janela, como os eventos Resize e Layout, e eventos de mouse e teclado de baixo nível. Alguns eventos de baixo nível são sintetizados por Control em eventos semânticos, como Click e DoubleClick. A maioria dos eventos partilhados enquadra-se nestas categorias:

  • Eventos do rato
  • Eventos de teclado
  • Eventos de alteração de propriedade
  • Outros eventos

Eventos do rato

Considerando que o Windows Forms é uma tecnologia de Interface do Usuário (UI), a entrada do mouse é a principal maneira pela qual os usuários interagem com um aplicativo do Windows Forms. Todos os controles fornecem eventos básicos relacionados ao mouse:

Para obter mais informações, consulte Usando eventos do mouse.

Eventos de teclado

Se o controle responde à entrada do usuário, como um controle TextBox ou Button, o evento de entrada apropriado é gerado para o controle. O controle deve estar focado para receber eventos do teclado. Alguns controles, como o controle Label, não podem ser focados e não podem receber eventos do teclado. Segue-se uma lista de eventos de teclado:

Para obter mais informações, consulte Usando eventos de teclado.

Eventos de alteração de propriedade

O Windows Forms segue o padrão PropertyNameChanged para propriedades que têm eventos de alteração. O mecanismo de vinculação de dados fornecido pelo Windows Forms reconhece esse padrão e se integra bem a ele. Ao criar seus próprios controles, implemente esse padrão.

Esse padrão implementa as seguintes regras, usando a propriedade FirstName como exemplo:

  • Dê um nome ao seu estabelecimento: FirstName.
  • Crie um evento para a propriedade usando o padrão PropertyNameChanged: FirstNameChanged.
  • Crie um método privado ou protegido usando o padrão OnPropertyNameChanged: OnFirstNameChanged.

Se o conjunto de propriedades FirstName modifica o valor de suporte, o método OnFirstNameChanged é chamado. O método OnFirstNameChanged gera o evento FirstNameChanged.

Aqui estão alguns dos eventos comuns de alteração de propriedade para um controlo:

Evento Descrição
BackColorChanged Ocorre quando o valor da propriedade BackColor é alterado.
BackgroundImageChanged Ocorre quando o valor da propriedade BackgroundImage é alterado.
BindingContextChanged Ocorre quando o valor da propriedade BindingContext é alterado.
DockChanged Ocorre quando o valor da propriedade Dock é alterado.
EnabledChanged Ocorre quando o valor da propriedade Enabled tenha sido alterado.
FontChanged Ocorre quando o valor da propriedade Font é alterado.
ForeColorChanged Ocorre quando o valor da propriedade ForeColor é alterado.
LocationChanged Ocorre quando o valor da propriedade Location foi alterado.
SizeChanged Ocorre quando o valor da propriedade Size é alterado.
VisibleChanged Ocorre quando o valor da propriedade Visible é alterado.

Para obter uma lista completa de eventos, consulte a seção Eventos da Classe de Controle.

Outros eventos

Os controles também gerarão eventos com base no estado do controle ou outras interações com o controle. Por exemplo, o evento é gerado se o controle tiver foco e o usuário pressionar a tecla F1 . Esse evento também é gerado se o utilizador pressionar o botão de Ajuda sensível ao contexto em um formulário e, em seguida, pressionar o cursor de ajuda no controlo.

Outro exemplo é quando um controle é alterado, movido ou redimensionado, o evento Paint é gerado. Este evento fornece ao desenvolvedor a oportunidade de desenhar no controle e alterar sua aparência.

Para obter uma lista completa de eventos, consulte a secção Eventos da Classe de Controlo.

Ver também