Freigeben über

ScrollableControl.Scroll Ereignis

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Tritt ein, wenn vom Benutzer oder von Code ein Bildlauf durch den Clientbereich durchgeführt wird.

public:
 event System::Windows::Forms::ScrollEventHandler ^ Scroll;
public event System.Windows.Forms.ScrollEventHandler Scroll;
public event System.Windows.Forms.ScrollEventHandler? Scroll;
member this.Scroll : System.Windows.Forms.ScrollEventHandler 
Public Custom Event Scroll As ScrollEventHandler

Ereignistyp

ScrollEventHandler

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses Scroll . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Ihnen beim Debuggen helfen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie erwägen, die Nachricht durch Console.WriteLine ein mehrzeilesiges TextBoxzu ersetzen MessageBox.Show oder anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance eines Typs enthält, der von ScrollableControlerbt, z. B. oder PanelContainerControl. Benennen Sie dann den instanceScrollableControl1, und stellen Sie sicher, dass der Ereignishandler dem Scroll Ereignis zugeordnet ist.

private void ScrollableControl1_Scroll(Object sender, ScrollEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ScrollOrientation", e.ScrollOrientation );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Type", e.Type );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "OldValue", e.OldValue );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "Scroll Event" );
}

Private Sub ScrollableControl1_Scroll(sender as Object, e as ScrollEventArgs) _ 
     Handles ScrollableControl1.Scroll

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ScrollOrientation", e.ScrollOrientation)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Type", e.Type)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "OldValue", e.OldValue)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"Scroll Event")

End Sub

Hinweise

Das Scroll Ereignis tritt auf, wenn der Benutzer durch den Clientbereich scrollt, indem er mit den Bildlaufleisten interagiert, oder wenn der Benutzer zwischen Steuerelementen navigiert und das aktive Steuerelement in die Ansicht scrollt. Das Scroll Ereignis tritt auch auf, wenn Sie Code schreiben, z. B. das Festlegen der AutoScrollPosition -Eigenschaft, der durch den Clientbereich scrollt.

Sie können die ScrollOrientation -Eigenschaft in Ihrem Ereignishandler verwenden, um die Ausrichtung der Bildlaufleiste für das Scroll Ereignis zu bestimmen.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen