Eventos de controle (Windows Forms .NET)

Artigo
11/05/2024

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.

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 and Layout , e eventos de mouse e teclado de baixo nível. Alguns eventos de baixo nível são sintetizados por 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 propriedade alterada
Outros eventos

Eventos do mouse

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

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

Eventos de propriedade alterada

O Windows Forms segue o padrão PropertyNameChanged para propriedades que têm eventos de alteração. O mecanismo de associaçã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 sua propriedade: 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 FirstName conjunto de propriedades modificar o valor de suporte, o OnFirstNameChanged método será chamado. O OnFirstNameChanged método gera o FirstNameChanged evento.

Aqui estão alguns dos eventos comuns de propriedade alterada 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 HelpRequested evento será gerado se o controle tiver foco e o usuário pressionar a tecla F1 . Esse evento também será gerado se o usuário pressionar o botão Ajuda contextual 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.