TrackBar.ValueChanged-Ereignis

Tritt ein, wenn die Value-Eigenschaft einer Trackleiste durch Bewegen des Bildlauffelds oder durch Bearbeitungen im Code geändert wird.

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

Syntax

'Declaration
Public Event ValueChanged As EventHandler
'Usage
Dim instance As TrackBar
Dim handler As EventHandler

AddHandler instance.ValueChanged, handler

public event EventHandler ValueChanged

public:
event EventHandler^ ValueChanged {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

/** @event */
public void add_ValueChanged (EventHandler value)

/** @event */
public void remove_ValueChanged (EventHandler value)

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Sie können dieses Ereignis verwenden, um andere Steuerelemente zu aktualisieren, wenn der in der Trackleiste dargestellte Wert geändert wird.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiel

Das folgende Codebeispiel veranschaulicht die Verwendung der Member TickStyle,Minimum und Maximum sowie die Behandlung des ValueChanged-Ereignisses. Zum Ausführen des Beispiels fügen Sie den folgenden Code in ein Formular ein, das ein TrackBar-Steuerelement mit dem Namen TrackBar1 und ein TextBox-Steuerelement mit dem Namen TextBox1 enthält. Rufen Sie die InitializeTrackBar-Methode aus dem Konstruktor oder der Load-Ereignisbehandlungsmethode des Formulars auf.

'Declare a new TrackBar object.
Friend WithEvents TrackBar1 As System.Windows.Forms.TrackBar

' Initalize the TrackBar and add it to the form.
Private Sub InitializeTrackBar()
    Me.TrackBar1 = New System.Windows.Forms.TrackBar

    ' Set the TickStyle property so there are ticks on both sides
    ' of the TrackBar.
    TrackBar1.TickStyle = TickStyle.Both

    ' Set the minimum and maximum number of ticks.
    TrackBar1.Minimum = 10
    TrackBar1.Maximum = 100

    ' Set the tick frequency to one tick every ten units.
    TrackBar1.TickFrequency = 10

    TrackBar1.Location = New System.Drawing.Point(75, 30)
    Me.Controls.Add(Me.TrackBar1)
End Sub


' Handle the TrackBar.ValueChanged event by calculating a value for
' TextBox1 based on the TrackBar value.  
Private Sub TrackBar1_ValueChanged(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles TrackBar1.ValueChanged
    TextBox1.Text = System.Math.Round(TrackBar1.Value / 10)
End Sub

//Declare a new TrackBar object.
internal System.Windows.Forms.TrackBar TrackBar1;

// Initalize the TrackBar and add it to the form.
private void InitializeTrackBar()
{
    this.TrackBar1 = new System.Windows.Forms.TrackBar();
    TrackBar1.Location = new System.Drawing.Point(75, 30);

    // Set the TickStyle property so there are ticks on both sides
    // of the TrackBar.
    TrackBar1.TickStyle = TickStyle.Both;

    // Set the minimum and maximum number of ticks.
    TrackBar1.Minimum = 10;
    TrackBar1.Maximum = 100;

    // Set the tick frequency to one tick every ten units.
    TrackBar1.TickFrequency = 10;

    // Associate the event-handling method with the 
    // ValueChanged event.
    TrackBar1.ValueChanged += 
        new System.EventHandler(TrackBar1_ValueChanged);
    this.Controls.Add(this.TrackBar1);
}


// Handle the TrackBar.ValueChanged event by calculating a value for
// TextBox1 based on the TrackBar value.  
private void TrackBar1_ValueChanged(object sender, System.EventArgs e)
{
    TextBox1.Text = (System.Math.Round(TrackBar1.Value/10.0)).ToString();
}

   //Declare a new TrackBar object.
internal:
   System::Windows::Forms::TrackBar^ TrackBar1;

   // Initalize the TrackBar and add it to the form.
private:
   void InitializeTrackBar()
   {
      this->TrackBar1 = gcnew System::Windows::Forms::TrackBar;
      TrackBar1->Location = System::Drawing::Point( 75, 30 );
      
      // Set the TickStyle property so there are ticks on both sides
      // of the TrackBar.
      TrackBar1->TickStyle = TickStyle::Both;
      
      // Set the minimum and maximum number of ticks.
      TrackBar1->Minimum = 10;
      TrackBar1->Maximum = 100;
      
      // Set the tick frequency to one tick every ten units.
      TrackBar1->TickFrequency = 10;
      
      // Associate the event-handling method with the 
      // ValueChanged event.
      TrackBar1->ValueChanged += gcnew System::EventHandler( this, &Form1::TrackBar1_ValueChanged );
      this->Controls->Add( this->TrackBar1 );
   }

   // Handle the TrackBar.ValueChanged event by calculating a value for
   // TextBox1 based on the TrackBar value.  
   void TrackBar1_ValueChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      TextBox1->Text = (System::Math::Round( TrackBar1->Value / 10.0 )).ToString();
   }

//Declare a new TrackBar object.
System.Windows.Forms.TrackBar trackBar1;

// Initalize the TrackBar and add it to the form.
private void InitializeTrackBar()
{
    this.trackBar1 = new System.Windows.Forms.TrackBar();
    trackBar1.set_Location(new System.Drawing.Point(75, 30));
    // Set the TickStyle property so there are ticks on both sides
    // of the TrackBar.
    trackBar1.set_TickStyle(TickStyle.Both);
    // Set the minimum and maximum number of ticks.
    trackBar1.set_Minimum(10);
    trackBar1.set_Maximum(100);
    // Set the tick frequency to one tick every ten units.
    trackBar1.set_TickFrequency(10);
    // Associate the event-handling method with the 
    // ValueChanged event.
    trackBar1.add_ValueChanged(new System.EventHandler(
        trackBar1_ValueChanged));
    this.get_Controls().Add(this.trackBar1);
} //InitializeTrackBar

// Handle the TrackBar.ValueChanged event by calculating a value for
// textBox1 based on the TrackBar value.  
private void trackBar1_ValueChanged(Object sender, System.EventArgs e)
{
    textBox1.set_Text(((System.Double)System.Math.Round(
        trackBar1.get_Value() / 10.0)).ToString());
} //trackBar1_ValueChanged

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

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