Cómo: Consumir eventos en una aplicación de formularios Windows Forms

Actualización: noviembre 2007

Un escenario común en las aplicaciones de Windows Forms es mostrar un formulario con controles y, a continuación, realizar una acción concreta basada en el control en el que el usuario hace clic. Por ejemplo, un control Button provoca un evento cuando el usuario hace clic en él en el formulario. Controlando el evento, la aplicación puede ejecutar la lógica de aplicación adecuada para ese clic del botón.

Para obtener más información sobre formularios Windows Forms, vea Introducción a los formularios Windows Forms.

Para controlar un evento de clic de un botón en un formulario Windows Forms

1. Cree un formulario Windows Forms que tenga un control Button.

   private Button button;
   

   Private WithEvents myButton As Button
   

2. Defina un controlador de eventos que coincida con la firma de delegado del evento Click. El evento Click utiliza la clase EventHandler para el tipo de delegado y la clase EventArgs para los datos del evento.

   void Button_Click(object sender, EventArgs e)
   {...}
   

   Sub Button_Click(sender As Object, e As EventArgs)
   ...
   End Sub
   

3. Agregue el método controlador de eventos al evento Click de Button.

   button.Click += new EventHandler(this.Button_Click);
   

   AddHandler myButton.Click, AddressOf Me.Button_Click
   

   Nota:
   Un diseñador (como Visual Studio 2005) realizará la conexión de este evento generando código similar al código de este ejemplo.

Ejemplo

En el siguiente ejemplo de código se controla el evento Click de un control Button para cambiar el color de fondo de un control TextBox. Los elementos en negrita muestran el controlador de eventos y cómo se conecta al evento Click de la instancia de Button.

El código de este ejemplo se ha escrito sin utilizar un diseñador visual (como Visual Studio 2005) y solamente contiene los elementos de programación esenciales. Si utiliza un diseñador, generará código adicional.

[C#]

using System;
using System.ComponentModel;
using System.Windows.Forms;
using System.Drawing;
public class MyForm : Form 
{
   private TextBox box;
   private Button button;

   public MyForm() : base() 
   {  
      box = new TextBox();
      box.BackColor = System.Drawing.Color.Cyan;
      box.Size = new Size(100,100);
      box.Location = new Point(50,50);
      box.Text = "Hello";

      button = new Button();
      button.Location = new Point(50,100);
      button.Text = "Click Me";

      // To wire the event, create
      // a delegate instance and add it to the Click event.
      button.Click += new EventHandler(this.Button_Click);
      Controls.Add(box);
      Controls.Add(button);   
   }
   // The event handler.
   private void Button_Click(object sender, EventArgs e)    {      box.BackColor = System.Drawing.Color.Green;   }
   // The STAThreadAttribute indicates that Windows Forms uses the
   // single-threaded apartment model.
   [STAThreadAttribute]
   public static void Main(string[] args) 
   {
      Application.Run(new MyForm());
   }
}

[Visual Basic]

Option Strict On

Imports System.ComponentModel
Imports System.Windows.Forms
Imports System.Drawing

Public Class MyForm
   Inherits Form
   Private box As TextBox
   Private WithEvents myButton As Button

   Public Sub New()
      box = New TextBox()
      box.BackColor = System.Drawing.Color.Cyan
      box.Size = New Size(100, 100)
      box.Location = New Point(50, 50)
      box.Text = "Hello"

      myButton = New Button()
      myButton.Location = New Point(50, 100)
      myButton.Text = "Click Me"

      AddHandler myButton.Click, AddressOf Me.Button_Click

      Controls.Add(box)
      Controls.Add(myButton)
   End Sub

   ' The event handler.
   Private Sub Button_Click(sender As Object, e As EventArgs)      box.BackColor = System.Drawing.Color.Green   End Sub

   ' The STAThreadAttribute indicates that Windows Forms uses the
   ' single-threaded apartment model.
   <STAThreadAttribute()> _
   Public Shared Sub Main(args() As String)
      Application.Run(New MyForm())
   End Sub
End Class

Compilar el código

Guarde el código anterior en un archivo (con extensión .cs si es un archivo de C# y .vb si es de Visual Basic 2005), compile y ejecútelo. Por ejemplo, si el archivo de código fuente se denomina WinEvents.cs (o WinEvents.vb), ejecute el comando siguiente.

csc /r:System.DLL /r:System.Windows.Forms.DLL /r:System.Drawing.DLL WinEvents.cs

vbc /r:System.DLL /r:System.Windows.Forms.DLL /r:System.Drawing.DLL WinEvents.vb

El archivo ejecutable se denominará WinEvents.exe.

Vea también

Conceptos

Eventos y delegados

Utilizar eventos

Provocar un evento

Otros recursos

Controlar y provocar eventos