ScrollBar.Scroll イベントとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ScrollBar.Scroll イベント

マウス操作またはキー操作によってスクロールボックスが移動すると発生します。

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

Visual Basic (宣言)

Public Event Scroll As ScrollEventHandler

Visual Basic (使用法)

Dim instance As ScrollBar
Dim handler As ScrollEventHandler

AddHandler instance.Scroll, handler

public event ScrollEventHandler Scroll

C++

public:
event ScrollEventHandler^ Scroll {
    void add (ScrollEventHandler^ value);
    void remove (ScrollEventHandler^ value);
}

/** @event */
public void add_Scroll (ScrollEventHandler
 value)

/** @event */
public void remove_Scroll (ScrollEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

派生クラス VScrollBar を使用するコード例を次に示します。Scroll イベントと ValueChanged イベントのイベントハンドラが作成されます。このコードは、Label および Button がフォーム上で作成されていること、およびボタンに Click イベントのイベントハンドラがあることを前提にしています。ボタンがクリックされると、スクロールバーの Value プロパティがコードで調整されます。ラベルには Value プロパティの現在の値とそのプロパティを変更したイベントが表示されます。スクロール値がボタンの Click イベントで変更されると、ValueChanged イベントだけを発生させます。反対に、スクロールバーが手動でスクロールされると、ValueChanged イベントの直後に Scroll イベントを発生させます。

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

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

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