RadioButton.OnCheckedChanged-Methode

Löst das CheckedChanged-Ereignis aus.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Protected Overridable Sub OnCheckedChanged ( _
    e As EventArgs _
)
'Usage
Dim e As EventArgs

Me.OnCheckedChanged(e)

protected virtual void OnCheckedChanged (
    EventArgs e
)

protected:
virtual void OnCheckedChanged (
    EventArgs^ e
)

protected void OnCheckedChanged (
    EventArgs e
)

protected function OnCheckedChanged (
    e : EventArgs
)

Parameter

• e
  Ein EventArgs, das die Ereignisdaten enthält.

Hinweise

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Auslösen eines Ereignisses.

Die OnCheckedChanged-Methode ermöglicht es auch abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Erben Wenn Sie OnCheckedChanged in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die OnCheckedChanged-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die CheckAlign-Eigenschaft zur Laufzeit geändert werden kann. Der Kontrollkästchenbereich eines RadioButton wird auf die rechte oder linke Seite des Textes verschoben, wenn der Checked-Wert geändert wird. Für dieses Beispiel ist es erforderlich, dass ein RadioButton-Steuerelement in einem Formular instanziiert und ein Verweis auf den System.Drawing-Namespace eingefügt wurde.

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

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:
   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.get_CheckAlign() == ContentAlignment.MiddleLeft) {
        radioButton1.set_CheckAlign(ContentAlignment.MiddleRight);
    }
    else {
        radioButton1.set_CheckAlign(ContentAlignment.MiddleLeft);
    }
} //radioButton1_CheckedChanged

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

RadioButton-Klasse
RadioButton-Member
System.Windows.Forms-Namespace