ScrollableControl.Scroll ScrollableControl.Scroll ScrollableControl.Scroll ScrollableControl.Scroll Event

Définition

Se produit lorsque l'utilisateur ou le code défile dans la zone cliente.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 

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre.The following code example demonstrates the use of this member. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de Scroll l’événement.In the example, an event handler reports on the occurrence of the Scroll event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging. Pour effectuer un rapport sur plusieurs événements ou sur des événements qui se produisent MessageBox.Show fréquemment Console.WriteLine , envisagez de remplacer ou d' TextBoxajouter le message à une ligne multiligne.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.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance d’un type qui ScrollableControlhérite de, Panel tel ContainerControlque ou.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. Nommez ensuite l' ScrollableControl1 instance et assurez-vous que le gestionnaire d' Scroll événements est associé à l’événement.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

Remarques

L' Scroll événement se produit lorsque l’utilisateur fait défiler la zone cliente en interagissant avec les barres de défilement, ou lorsque l’utilisateur navigue entre les contrôles et que le contrôle actif fait défiler l’affichage.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. L' Scroll événement se produit également lorsque vous écrivez du code, tel que AutoScrollPosition la définition de la propriété, qui fait défiler la zone cliente.The Scroll event also occurs when you write code, such as setting the AutoScrollPosition property, that scrolls through the client area.

Vous pouvez utiliser la ScrollOrientation propriété dans votre gestionnaire d’événements pour déterminer l’orientation de la barre Scroll de défilement pour l’événement.You can use the ScrollOrientation property in your event handler to determine the scroll bar orientation for the Scroll event.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.For more information about how to handle events, see Handling and Raising Events.

S’applique à

Voir aussi