ScrollableControl.Scroll Événement

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 l’événement Scroll.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 fréquemment, envisagez de remplacer MessageBox.Show par Console.WriteLine ou d’ajouter le message à un TextBoxmultiligne.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 hérite de ScrollableControl, tel qu’un Panel ou ContainerControl.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’instance ScrollableControl1 et assurez-vous que le gestionnaire d’événements est associé à l’événement Scroll.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’événement Scroll 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’événement Scroll se produit également lorsque vous écrivez du code, tel que la définition de la propriété AutoScrollPosition, 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 propriété ScrollOrientation dans votre gestionnaire d’événements pour déterminer l’orientation de la barre de défilement pour l’événement Scroll.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