ScrollableControl.Scroll Ereignis

Definition

Tritt ein, wenn vom Benutzer oder von Code ein Bildlauf durch den Clientbereich durchgeführt wird.Occurs when the user or code scrolls through the client area.

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 

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht.The following code example demonstrates the use of this member. Im Beispiel meldet ein Ereignishandler das Vorkommen des Scroll Ereignisses.In the example, an event handler reports on the occurrence of the Scroll event. Mit diesem Bericht können Sie lernen, wann das Ereignis auftritt und Sie beim Debuggen unterstützen können.This report helps you to learn when the event occurs and can assist you in debugging. Wenn Sie mehrere Ereignisse oder Ereignisse, die häufig auftreten, melden möchten, MessageBox.Show empfiehlt Console.WriteLine es sich, durch zu ersetzen oder die Nachricht TextBoxan eine mehrzeilige anfügen.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz eines Typs enthält, der ScrollableControlvon erbt, Panel z ContainerControl. b. oder.To run the example code, paste it into a project that contains an instance of a type that inherits from ScrollableControl, such as a Panel or ContainerControl. Benennen Sie dann die ScrollableControl1 Instanz, und stellen Sie sicher, dass der Ereignis Scroll Handler dem Ereignis zugeordnet ist.Then name the instance ScrollableControl1 and ensure that the event handler is associated with the Scroll event.

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 einen Bildlauf durch den Client Bereich durchführt, indem er mit den Scrollleisten interagiert oder wenn der Benutzer zwischen Steuerelementen navigiert und das aktive Steuerelement in die Ansicht wechselt.The Scroll event occurs when the user scrolls through the client area by interacting with the scroll bars, or when the user navigates between controls and the active control scrolls into view. Das Scroll Ereignis tritt auch auf, wenn Sie Code schreiben, z. AutoScrollPosition b. das Festlegen der-Eigenschaft, die durch den Client Bereich rollt.The Scroll event also occurs when you write code, such as setting the AutoScrollPosition property, that scrolls through the client area.

Sie können die ScrollOrientation -Eigenschaft im Ereignishandler verwenden, um die Bildschirm Ausrichtung der Bild Lauf Scroll Leiste für das Ereignis zu bestimmen.You can use the ScrollOrientation property in your event handler to determine the scroll bar orientation for the Scroll event.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about how to handle events, see Handling and Raising Events.

Gilt für:

Siehe auch