ScrollEventArgs クラス

.NET Framework クラス ライブラリ リファレンス

ScrollEventArgs クラス

Scroll イベントのデータを提供します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class ScrollEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As ScrollEventArgs

C#

[ComVisibleAttribute(true)] 
public class ScrollEventArgs : EventArgs

C++

[ComVisibleAttribute(true)] 
public ref class ScrollEventArgs : public
 EventArgs

J#

/** @attribute ComVisibleAttribute(true) */ 
public class ScrollEventArgs extends EventArgs

JScript

ComVisibleAttribute(true) 
public class ScrollEventArgs extends
 EventArgs

解説

Scroll イベントは、ユーザーがスクロール バーの値を変更すると発生します。このイベントは、スクロール バーの矢印ボタンのクリック、↑キーまたは↓キーの使用、スクロール ボックスのドラッグなど、さまざまなアクションによって発生します。ScrollEventArgs は、発生したスクロール イベントの種類、およびスクロール バーの新しい値を指定します。Scroll イベントのスクロール バーの方向を確認するには、ScrollOrientation イベントを使用します。

Scroll イベントは、DataGridView、ScrollableControl、ScrollBar および DataGrid の各コントロールに対して発生します。

使用例

Visual Basic

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

C#

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;
    }
 }
 

C++

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;
   }
}

J#

private void AddMyScrollEventHandlers()
{
    // Create and initialize a VScrollBar.
    VScrollBar vScrollBar1 = new VScrollBar();

    // Add event handlers for the OnScroll and OnValueChanged events.
    vScrollBar1.add_Scroll(
        new ScrollEventHandler(this.vScrollBar1_Scroll));
    vScrollBar1.add_ValueChanged(
        new EventHandler(this.vScrollBar1_ValueChanged));
} //AddMyScrollEventHandlers

// Create the ValueChanged event handler.
private void vScrollBar1_ValueChanged(Object
 sender, EventArgs e)
{
    // Display the new value in the label.
    label1.set_Text("vScrollBar Value:(OnValueChanged Event) " 
        + vScrollBar1.get_Value());
} //vScrollBar1_ValueChanged

// Create the Scroll event handler.
private void vScrollBar1_Scroll(Object sender,
 ScrollEventArgs e)
{
    // Display the new value in the label.
    label1.set_Text(
        "VScrollBar Value:(OnScroll Event) " + e.get_NewValue());
} //vScrollBar1_Scroll

private void button1_Click(Object sender, EventArgs
 e)
{
    // Add 40 to the Value property if it will not exceed the Maximum
 
    // value.
    if (vScrollBar1.get_Value() + 40 < vScrollBar1.get_Maximum())
 {
        vScrollBar1.set_Value(vScrollBar1.get_Value() + 40);
    }
} //button1_Click

継承階層

System.Object
   System.EventArgs
    System.Windows.Forms.ScrollEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ScrollEventArgs メンバ
System.Windows.Forms 名前空間
ScrollBar.Scroll イベント
ScrollBar クラス
DataGridView クラス
DataGrid クラス