ScrollEventArgs Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt Daten für das Scroll-Ereignis bereit.

public ref class ScrollEventArgs : EventArgs

public class ScrollEventArgs : EventArgs

type ScrollEventArgs = class
    inherit EventArgs

Public Class ScrollEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

ScrollEventArgs

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht.

void AddMyScrollEventHandlers()
{
   // Create and initialize a VScrollBar.
   VScrollBar^ vScrollBar1 = gcnew VScrollBar;

   // Add event handlers for the OnScroll and OnValueChanged events.
   vScrollBar1->Scroll += gcnew ScrollEventHandler( this, &Form1::vScrollBar1_Scroll );
   vScrollBar1->ValueChanged += gcnew EventHandler( this, &Form1::vScrollBar1_ValueChanged );
}

// Create the ValueChanged event handler.
void vScrollBar1_ValueChanged( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Display the new value in the label.
   label1->Text = String::Format( "vScrollBar Value:(OnValueChanged Event) {0}", vScrollBar1->Value );
}

// Create the Scroll event handler.
void vScrollBar1_Scroll( Object^ /*sender*/, ScrollEventArgs^ e )
{
   // Display the new value in the label.
   label1->Text = String::Format( "VScrollBar Value:(OnScroll Event) {0}", e->NewValue );
}

void button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Add 40 to the Value property if it will not exceed the Maximum value.
   if ( vScrollBar1->Value + 40 < vScrollBar1->Maximum )
   {
      vScrollBar1->Value = vScrollBar1->Value + 40;
   }
}

private void AddMyScrollEventHandlers()
 {
    // Create and initialize a VScrollBar.
    VScrollBar vScrollBar1 = new VScrollBar();
 
    // Add event handlers for the OnScroll and OnValueChanged events.
    vScrollBar1.Scroll += new ScrollEventHandler(
       this.vScrollBar1_Scroll);
    vScrollBar1.ValueChanged += new EventHandler(
       this.vScrollBar1_ValueChanged); 
 }
 
 // Create the ValueChanged event handler.
 private void vScrollBar1_ValueChanged(Object sender, 
                                       EventArgs e)
 {
     // Display the new value in the label.
     label1.Text = "vScrollBar Value:(OnValueChanged Event) " + vScrollBar1.Value.ToString();
 }
 
 // Create the Scroll event handler.
 private void vScrollBar1_Scroll(Object sender, 
                                 ScrollEventArgs e)
 {
     // Display the new value in the label.
     label1.Text = "VScrollBar Value:(OnScroll Event) " + e.NewValue.ToString();
 }
 
 private void button1_Click(Object sender, 
                           EventArgs e)
 {
    // Add 40 to the Value property if it will not exceed the Maximum value.
    if (vScrollBar1.Value + 40 < vScrollBar1.Maximum)
    {
        vScrollBar1.Value = vScrollBar1.Value + 40;
    }
 }

Private Sub AddMyScrollEventHandlers()
    ' Create and initialize a VScrollBar.
    Dim vScrollBar1 As New VScrollBar()
    
    ' Add event handlers for the OnScroll and OnValueChanged events.
    AddHandler vScrollBar1.Scroll, AddressOf Me.vScrollBar1_Scroll
    AddHandler vScrollBar1.ValueChanged, AddressOf Me.vScrollBar1_ValueChanged
End Sub    

' Create the ValueChanged event handler.
Private Sub vScrollBar1_ValueChanged(sender As Object, e As EventArgs)
    ' Display the new value in the label.
    label1.Text = "vScrollBar Value:(OnValueChanged Event) " & _
        vScrollBar1.Value.ToString()
End Sub    

' Create the Scroll event handler.
Private Sub vScrollBar1_Scroll(sender As Object, e As ScrollEventArgs)
    ' Display the new value in the label.
    label1.Text = "VScrollBar Value:(OnScroll Event) " & _
        e.NewValue.ToString()
End Sub    

Private Sub button1_Click(sender As Object, e As EventArgs)
    ' Add 40 to the Value property if it will not exceed the Maximum value.
    If vScrollBar1.Value + 40 < vScrollBar1.Maximum Then
        vScrollBar1.Value = vScrollBar1.Value + 40
    End If
End Sub

Hinweise

Das Scroll Ereignis tritt auf, wenn der Benutzer den Wert der Bildlaufleiste ändert. Dieses Ereignis kann aus einer Vielzahl von Aktionen resultieren, z. B. durch Klicken auf einen Pfeil in der Bildlaufleiste, Drücken der NACH-OBEN- oder NACH-UNTEN-TASTE oder Ziehen des Bildlauffelds. Gibt ScrollEventArgs den Typ des aufgetretenen Bildlaufereignisses und den neuen Wert der Bildlaufleiste an. Verwenden Sie die ScrollOrientation -Eigenschaft, um die Ausrichtung der Bildlaufleiste für das Scroll Ereignis zu bestimmen.

Das Scroll Ereignis tritt für die DataGridViewSteuerelemente , ScrollableControl, ScrollBarund DataGrid auf.

Konstruktoren

ScrollEventArgs(ScrollEventType, Int32)	Initialisiert eine neue Instanz der ScrollEventArgs-Klasse unter Verwendung der angegebenen Werte für die Type-Eigenschaft und die NewValue-Eigenschaft.
ScrollEventArgs(ScrollEventType, Int32, Int32)	Initialisiert eine neue Instanz der ScrollEventArgs-Klasse unter Verwendung der angegebenen Werte für die Type-Eigenschaft, die OldValue-Eigenschaft und die NewValue-Eigenschaft.
ScrollEventArgs(ScrollEventType, Int32, Int32, ScrollOrientation)	Initialisiert eine neue Instanz der ScrollEventArgs-Klasse unter Verwendung der angegebenen Werte für die Type-Eigenschaft, die OldValue-Eigenschaft, die NewValue-Eigenschaft und die ScrollOrientation-Eigenschaft.
ScrollEventArgs(ScrollEventType, Int32, ScrollOrientation)	Initialisiert eine neue Instanz der ScrollEventArgs-Klasse unter Verwendung der angegebenen Werte für die Type-Eigenschaft, die NewValue-Eigenschaft und die ScrollOrientation-Eigenschaft.

Eigenschaften

NewValue	Ruft den neuen Value der Schiebeleiste ab oder legt diesen fest.
OldValue	Ruft den alten Value der Schiebeleiste ab.
ScrollOrientation	Ruft die Schiebeleistenausrichtung ab, die das Scroll-Ereignis ausgelöst hat.
Type	Ruft den Typ des eingetretenen Bildlaufereignisses ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Scroll
• ScrollBar
• DataGridView
• DataGrid