RadioButton.OnCheckedChanged(EventArgs) Método

Definición

Genera el evento CheckedChanged.Raises the CheckedChanged event.

protected:
 virtual void OnCheckedChanged(EventArgs ^ e);
protected virtual void OnCheckedChanged (EventArgs e);
abstract member OnCheckedChanged : EventArgs -> unit
override this.OnCheckedChanged : EventArgs -> unit
Protected Overridable Sub OnCheckedChanged (e As EventArgs)

Parámetros

e
EventArgs

Objeto EventArgs que contiene los datos del evento.An EventArgs that contains the event data.

Ejemplos

En el ejemplo de código siguiente se CheckAlign muestra cómo se puede cambiar la propiedad en tiempo de ejecución.The following code example demonstrates how the CheckAlign property can be changed at run time. La parte de casilla de un RadioButton se mueve a la derecha o a la izquierda del texto cuando Checked cambia el valor.The check box portion of a RadioButton is moved to the right or left of the text when the Checked value changes. En este ejemplo se requiere RadioButton que se haya creado una instancia de un control en un formulario y que System.Drawing se haya incluido una referencia al espacio de nombres.This example requires that a RadioButton control has been instantiated on a form and that a reference to the System.Drawing namespace has been included.

private:
   Void radioButton1_CheckedChanged( System::Object^ sender, System::EventArgs^ e )
   {
      // Change the check box position to be opposite its current position.
      if ( radioButton1->CheckAlign == ContentAlignment::MiddleLeft )
      {
         radioButton1->CheckAlign = ContentAlignment::MiddleRight;
      }
      else
      {
         radioButton1->CheckAlign = ContentAlignment::MiddleLeft;
      }
   }
private void radioButton1_CheckedChanged(Object sender, 
                                         EventArgs e)
{
   /* Change the check box position to 
   be the opposite its current position.*/
   if (radioButton1.CheckAlign == ContentAlignment.MiddleLeft)
   {
      radioButton1.CheckAlign = ContentAlignment.MiddleRight;
   }
   else
   {
      radioButton1.CheckAlign = ContentAlignment.MiddleLeft;
   }
}

Private Sub radioButton1_CheckedChanged(sender As Object, e As EventArgs)
    ' Change the check box position to
    ' be the opposite its current position.
    If radioButton1.CheckAlign = ContentAlignment.MiddleLeft Then
        radioButton1.CheckAlign = ContentAlignment.MiddleRight
    Else
        radioButton1.CheckAlign = ContentAlignment.MiddleLeft
    End If
End Sub

Comentarios

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado.Raising an event invokes the event handler through a delegate. Para obtener más información, consulte controlar y provocar eventos.For more information, see Handling and Raising Events.

El método OnCheckedChanged también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado.The OnCheckedChanged method also allows derived classes to handle the event without attaching a delegate. Ésta es la técnica preferida para controlar el evento en una clase derivada.This is the preferred technique for handling the event in a derived class.

Notas a los desarrolladores de herederos

Al reemplazar OnCheckedChanged(EventArgs) en una clase derivada, asegúrese de llamar al OnCheckedChanged(EventArgs) método de la clase base para que los delegados registrados reciban el evento.When overriding OnCheckedChanged(EventArgs) in a derived class, be sure to call the base class' OnCheckedChanged(EventArgs) method so that registered delegates receive the event.

Se aplica a