ScrollEventArgs Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Proporciona datos para el evento Scroll.

public ref class ScrollEventArgs : EventArgs

public class ScrollEventArgs : EventArgs

type ScrollEventArgs = class
    inherit EventArgs

Public Class ScrollEventArgs
Inherits EventArgs

Herencia

Object

EventArgs

ScrollEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro.

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

Comentarios

El Scroll evento se produce cuando el usuario cambia el valor de la barra de desplazamiento. Este evento puede deberse a diversas acciones, como hacer clic en una flecha de barra de desplazamiento, presionar la FLECHA ARRIBA o FLECHA ABAJO, o arrastrar el cuadro de desplazamiento. ScrollEventArgs especifica el tipo de evento de desplazamiento que se produjo y el nuevo valor de la barra de desplazamiento. Utilice la ScrollOrientation propiedad para determinar la orientación de la barra de desplazamiento para el Scroll evento.

El Scroll evento se produce para los DataGridViewcontroles , ScrollableControl, ScrollBary DataGrid .

Constructores

ScrollEventArgs(ScrollEventType, Int32)	Inicializa una nueva instancia de la clase ScrollEventArgs utilizando los valores determinados para las propiedades Type y NewValue.
ScrollEventArgs(ScrollEventType, Int32, Int32)	Inicializa una nueva instancia de la clase ScrollEventArgs utilizando los valores determinados para las propiedades Type, OldValue y NewValue.
ScrollEventArgs(ScrollEventType, Int32, Int32, ScrollOrientation)	Inicializa una nueva instancia de la clase ScrollEventArgs utilizando los valores determinados para las propiedades Type, OldValue, NewValue y ScrollOrientation.
ScrollEventArgs(ScrollEventType, Int32, ScrollOrientation)	Inicializa una nueva instancia de la clase ScrollEventArgs utilizando los valores determinados para las propiedades Type, NewValue y ScrollOrientation.

Propiedades

NewValue	Obtiene o establece la nueva propiedad Value de la barra de desplazamiento.
OldValue	Obtiene el Value anterior de la barra de desplazamiento.
ScrollOrientation	Obtiene la orientación de la barra de desplazamiento que generó el evento Scroll.
Type	Obtiene el tipo de evento de desplazamiento que se ha producido.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• Scroll
• ScrollBar
• DataGridView
• DataGrid