Compartilhar via

Eventos de controle

Os controles fornecem eventos 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 a visão geral de eventos e manipulação e geração de eventos.

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

Eventos comuns

Os controles fornecem mais de 60 eventos por meio da classe Controlbase. 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 compartilhados se enquadra nessas categorias:

  • Eventos do mouse
  • Eventos de teclado
  • Eventos de mudança de propriedade
  • Outros eventos

Eventos do mouse

Considerando que o Windows Forms é uma tecnologia de interface do usuário, 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 Como usar 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 estar 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 mudança de propriedade

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 backup, o OnFirstNameChanged 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:

Acontecimento Descrição
BackColorChanged Ocorre quando o valor da BackColor propriedade é alterado.
BackgroundImageChanged Ocorre quando o valor da BackgroundImage propriedade é alterado.
BindingContextChanged Ocorre quando o valor da BindingContext propriedade é alterado.
DockChanged Ocorre quando o valor da Dock propriedade é alterado.
EnabledChanged Ocorre quando o valor da propriedade Enabled é alterado.
FontChanged Ocorre quando o valor da Font propriedade é alterado.
ForeColorChanged Ocorre quando o valor da ForeColor propriedade é alterado.
LocationChanged Ocorre quando o valor da propriedade Location é alterado.
SizeChanged Ocorre quando o valor da Size propriedade é alterado.
VisibleChanged Ocorre quando o valor da Visible propriedade é 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 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 pressionar o cursor de ajuda no controle.

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

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

Consulte também