Compartir a través de

Eventos de control (Windows Forms .NET)

  • Artículo

Los controles proporcionan eventos que se generan cuando el usuario interactúa con el control o cuando cambia el estado de este. En este artículo se describen los eventos comunes compartidos por la mayoría de los controles, los eventos que genera la interacción del usuario y los eventos únicos de controles específicos. Para más información sobre los eventos en Windows Forms, vea Información general sobre eventos (Windows Forms para .NET) y Control y generación de eventos.

Importante

La documentación de la guía de escritorio para .NET 7 y .NET 6 está en proceso de elaboración.

Para más información sobre cómo agregar o quitar un controlador de eventos de control, vea Cómo controlar un evento de control (Windows Forms .NET).

Eventos comunes

Los controles proporcionan más de 60 eventos a través de la clase base Control. Entre ellos se incluye el evento Paint, que hace que se dibuje un control, eventos relacionados con la visualización de una ventana, como los eventos Resize y Layout, y eventos de nivel inferior del ratón y teclado. Control sintetiza algunos eventos de nivel inferior en eventos semánticos como Click y DoubleClick. La mayoría de los eventos compartidos se encuentra en estas categorías:

  • Eventos de mouse
  • Eventos de teclado
  • Eventos de propiedad cambiada
  • Otros eventos

Eventos de mouse

Teniendo en cuenta que Windows Forms es una tecnología de Interfaz de usuario (UI), las entradas del mouse es la forma principal en que los usuarios interactúan con una de sus aplicaciones. Todos los controles proporcionan eventos básicos relacionados con el mouse:

Para más información, consulte Uso de eventos del mouse (Windows Forms para .NET).

Eventos de teclado

Si el control responde a la entrada del usuario, como un control TextBox o Button, se genera el evento de entrada adecuado para el control. El control debe centrarse para recibir eventos de teclado. Algunos controles, como el control Label, no se pueden centrar y no pueden recibir eventos de teclado. A continuación se muestra una lista de eventos de teclado:

Para más información, consulte Uso de eventos de teclado.

Eventos de propiedad cambiada

Windows Forms sigue el patrón PropertyNameChanged para las propiedades que tienen eventos de cambio. El motor de enlace de datos proporcionado por Windows Forms reconoce este patrón y se integra bien con él. Al crear sus propios controles, implemente este patrón.

Este patrón implementa las reglas siguientes, mediante la propiedad FirstName como ejemplo:

  • Asigne un nombre a la propiedad: FirstName.
  • Cree un evento para la propiedad mediante el patrón PropertyNameChanged: FirstNameChanged.
  • Cree un método privado o protegido mediante el patrón OnPropertyNameChanged: OnFirstNameChanged.

Si el conjunto de propiedades FirstName modifica el valor de respaldo, se llama al método OnFirstNameChanged. El método OnFirstNameChanged genera el evento FirstNameChanged.

Estos son algunos de los eventos comunes de propiedad cambiada para un control:

Evento Descripción
BackColorChanged Se produce cuando cambia el valor de la propiedad BackColor.
BackgroundImageChanged Se produce cuando cambia el valor de la propiedad BackgroundImage.
BindingContextChanged Se produce cuando cambia el valor de la propiedad BindingContext.
DockChanged Se produce cuando cambia el valor de la propiedad Dock.
EnabledChanged Se produce cuando cambia el valor de la propiedad Enabled.
FontChanged Se produce cuando cambia el valor de la propiedad Font.
ForeColorChanged Se produce cuando cambia el valor de la propiedad ForeColor.
LocationChanged Se produce cuando cambia el valor de la propiedad Location.
SizeChanged Se produce cuando cambia el valor de la propiedad Size.
VisibleChanged Se produce cuando cambia el valor de la propiedad Visible.

Para obtener una lista completa de eventos, vea la sección Eventos de la Clase de control.

Otros eventos

Los controles también generarán eventos basados en el estado del control u otras interacciones con el control. Por ejemplo, el evento HelpRequested se genera si el control tiene el foco y el usuario presiona la tecla F1. Este evento también se genera si el usuario presiona el botón Ayuda contextual en un formulario y, después, presiona el cursor de ayuda en el control.

Otro ejemplo es que el evento Paint se genera cuando se cambia, mueve o cambia el tamaño de un control. Este evento proporciona al desarrollador la oportunidad de dibujar en el control y cambiar su apariencia.

Para obtener una lista completa de eventos, vea la sección Eventos de la Clase de control.

Vea también