Compartilhar 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 é alterado. Este artigo descreve os eventos comuns compartilhados pela maioria dos controles, eventos gerados pela interação do usuário e eventos exclusivos de controles específicos. Para obter mais informações sobre eventos no Windows Forms, consulte Visão geral de eventos e Manipulando e gerando eventos.

Importante

A documentação do Guia da Área de Trabalho para .NET 7 e .NET 6 está em construção.

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

Eventos comuns

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

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

Eventos do mouse

Considerando que o Windows Forms é uma tecnologia de interface do usuário (UI), a entrada do mouse é a principal maneira de os usuários interagirem 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 responder à entrada do usuário, como um TextBox ou Button controle, o evento de entrada apropriado será gerado para o controle. O controle deve ser focado para receber eventos do teclado. Alguns controles, como o Label controle, não podem ser focados e não podem receber eventos do teclado. Veja a seguir 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:

  • Nomeie seu imóvel: 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 modificar o valor de suporte, o FirstNameOnFirstNameChanged método será chamado. O OnFirstNameChanged método gera o FirstNameChanged evento.

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

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

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 em outras interações com o controle. Por exemplo, o evento é gerado se o controle tiver foco e o HelpRequested usuário pressionar a tecla F1 . Esse evento também será gerado se o usuário pressionar o botão Ajuda sensível ao contexto em um formulário e, em seguida, pressionar o cursor de ajuda no controle.

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

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

Confira também