ScrollBar.Scroll 事件

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

ScrollBar.cs

在通过鼠标或键盘操作移动滚动框后发生。

C#

public event System.Windows.Forms.ScrollEventHandler? Scroll;

事件类型

ScrollEventHandler

示例

以下示例滚动图片框中的图像。 每当用户滚动时，它都使用 Value 滚动条的 来重新绘制图像的新部分。 此代码示例是为类概述提供的更大示例的 ScrollBar 一部分。

备注

有关如何在 Visual Studio 中运行此示例的说明，请参阅如何：使用 Visual Studio 编译和运行完整Windows 窗体代码示例。

C#

private void HandleScroll(Object sender, ScrollEventArgs e)
{
    //Create a graphics object and draw a portion of the image in the PictureBox.
    Graphics g = pictureBox1.CreateGraphics();

    int xWidth = pictureBox1.Width;
    int yHeight = pictureBox1.Height;

    int x;
    int y;

    if (e.ScrollOrientation == ScrollOrientation.HorizontalScroll)
    {
        x = e.NewValue;
        y = vScrollBar1.Value;
    }
    else //e.ScrollOrientation == ScrollOrientation.VerticalScroll
    {
        y = e.NewValue;
        x = hScrollBar1.Value;
    }

    g.DrawImage(pictureBox1.Image,
      new Rectangle(0, 0, xWidth, yHeight),  //where to draw the image
      new Rectangle(x, y, xWidth, yHeight),  //the portion of the image to draw
      GraphicsUnit.Pixel);

    pictureBox1.Update();
}

下面的代码示例使用派生类 VScrollBar。 创建 和 ValueChanged 事件的事件处理程序Scroll。 此代码假定 Label 已在窗体上创建了 和 Button ，并且按钮具有事件的 Click 事件处理程序。 单击按钮时， Value 滚动条的属性将在代码中调整。 标签将显示属性的 Value 当前值以及更改该属性的事件。 你会注意到，当滚动值由按钮的事件 Click 更改时，只会引发该 ValueChanged 事件。 相比之下，当手动滚动滚动条时，事件在 Scroll 事件之后 ValueChanged 立即引发。

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

注解

有关如何处理事件的详细信息，请参阅 处理和引发事件。

适用于

另请参阅

• OnScroll(ScrollEventArgs)
• ScrollEventHandler