Eventos de control (Windows Forms .NET)

Artículo
11/05/2024

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.

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.