ScrollEventArgs Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

ScrollEventArgs.cs

Предоставляет данные для события 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элементов управления , ScrollableControlScrollBarи DataGrid элементов управления.

Конструкторы

Имя	Описание
ScrollEventArgs(ScrollEventType, Int32, Int32, ScrollOrientation)	Инициализирует новый экземпляр ScrollEventArgs класса с помощью заданных значений для Typeсвойств , NewValueOldValueи ScrollOrientation свойств.
ScrollEventArgs(ScrollEventType, Int32, Int32)	Инициализирует новый экземпляр класса с помощью заданных значений ScrollEventArgs для Typeсвойств OldValueи NewValue свойств.
ScrollEventArgs(ScrollEventType, Int32, ScrollOrientation)	Инициализирует новый экземпляр класса с помощью заданных значений ScrollEventArgs для Typeсвойств NewValueи ScrollOrientation свойств.
ScrollEventArgs(ScrollEventType, Int32)	Инициализирует новый экземпляр ScrollEventArgs класса с помощью заданных значений для Type свойств и NewValue свойств.

Свойства

Имя	Описание
NewValue	Возвращает или задает новую Value полосу прокрутки.
OldValue	Возвращает старое значение Value полосы прокрутки.
ScrollOrientation	Возвращает ориентацию полосы прокрутки, которая вызвала Scroll событие.
Type	Возвращает тип события прокрутки, которое произошло.

См. также раздел

• Scroll
• ScrollBar
• DataGridView
• DataGrid