ScrollEventArgs 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

为 Scroll 事件提供数据。

public ref class ScrollEventArgs : EventArgs

public class ScrollEventArgs : EventArgs

type ScrollEventArgs = class
    inherit EventArgs

Public Class ScrollEventArgs
Inherits EventArgs

继承

Object

EventArgs

ScrollEventArgs

示例

下面的代码示例演示了此成员的用法。

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

注解

Scroll当用户更改滚动条的值时，将发生 该事件。 此事件可能由各种操作导致，例如单击滚动条箭头、按向上键或向下键或拖动滚动框。 指定 ScrollEventArgs 发生的滚动事件的类型和滚动条的新值。 ScrollOrientation使用 属性确定事件的滚动条方向Scroll。

事件 Scroll 针对 DataGridView、 ScrollableControl、 ScrollBar和 DataGrid 控件发生。

构造函数

ScrollEventArgs(ScrollEventType, Int32)	使用 ScrollEventArgs 和 Type 属性的给定值初始化 NewValue 类的新实例。
ScrollEventArgs(ScrollEventType, Int32, Int32)	使用 ScrollEventArgs、Type 和 OldValue 属性的给定值初始化 NewValue 类的新实例。
ScrollEventArgs(ScrollEventType, Int32, Int32, ScrollOrientation)	使用 ScrollEventArgs、Type、OldValue 和 NewValue 属性的给定值初始化 ScrollOrientation 类的新实例。
ScrollEventArgs(ScrollEventType, Int32, ScrollOrientation)	使用 ScrollEventArgs、Type 和 NewValue 属性的给定值初始化 ScrollOrientation 类的新实例。

属性

NewValue	获取或设置滚动条的新 Value。
OldValue	获取滚动条的旧 Value 值。
ScrollOrientation	获取引发 Scroll 事件的滚动条方向。
Type	获取所发生的滚动事件的类型。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• Scroll
• ScrollBar
• DataGridView
• DataGrid