ScrollEventArgs Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit des données pour l'événement Scroll.

public ref class ScrollEventArgs : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public class ScrollEventArgs : EventArgs

public class ScrollEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type ScrollEventArgs = class
    inherit EventArgs

type ScrollEventArgs = class
    inherit EventArgs

Public Class ScrollEventArgs
Inherits EventArgs

Héritage: Object

EventArgs
ScrollEventArgs

Attributs: ComVisibleAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre.

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

Remarques

L’événement Scroll se produit lorsque l’utilisateur modifie la valeur de la barre de défilement. Cet événement peut résulter d’une variété d’actions, telles que cliquer sur une flèche de barre de défilement, appuyer sur la FLÈCHE HAUT ou FLÈCHE BAS, ou faire glisser la zone de défilement. spécifie ScrollEventArgs le type d’événement de défilement qui s’est produit et la nouvelle valeur de la barre de défilement. Utilisez la ScrollOrientation propriété pour déterminer l’orientation de la barre de défilement de l’événement Scroll .

L’événement Scroll se produit pour les DataGridViewcontrôles , ScrollableControl, ScrollBaret DataGrid .

Constructeurs

ScrollEventArgs(ScrollEventType, Int32)	Initialise une nouvelle instance de la classe ScrollEventArgs à l'aide des valeurs données pour les propriétés Type et NewValue.
ScrollEventArgs(ScrollEventType, Int32, Int32)	Initialise une nouvelle instance de la classe ScrollEventArgs à l'aide des valeurs indiquées pour les propriétés Type, OldValue et NewValue.
ScrollEventArgs(ScrollEventType, Int32, Int32, ScrollOrientation)	Initialise une nouvelle instance de la classe ScrollEventArgs à l'aide des valeurs données pour les propriétés Type, OldValue, NewValue et ScrollOrientation.
ScrollEventArgs(ScrollEventType, Int32, ScrollOrientation)	Initialise une nouvelle instance de la classe ScrollEventArgs à l'aide des valeurs indiquées pour les propriétés Type, NewValue et ScrollOrientation.

Propriétés

NewValue	Obtient ou définit le nouveau Value de la barre de défilement.
OldValue	Obtient l'ancien Value de la barre de défilement.
ScrollOrientation	Obtient l'orientation de la barre de défilement qui déclenché l'événement `Scroll`.
Type	Obtient le type d'événement de défilement survenu.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Produit	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Partager via