ScrollBar.Value Property


Gets or sets a numeric value that represents the current position of the scroll box on the scroll bar control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public int Value { get; set; }

Property Value

Type: System.Int32

A numeric value that is within the Minimum and Maximum range. The default value is 0.

Exception Condition

The assigned value is less than the Minimum property value.


The assigned value is greater than the Maximum property value.

The following example scrolls an image in a picture box. It uses the Value of the scrollbar to redraw a new part of the image whenever the user scrolls. This code example is part of a larger example provided for the ScrollBar class overview.


For instructions about how to run this example in Visual Studio, see How to: Compile and Run a Complete Windows Forms Code Example Using Visual Studio.

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;

      new Rectangle(0, 0, xWidth, yHeight),  //where to draw the image
      new Rectangle(x, y, xWidth, yHeight),  //the portion of the image to draw


.NET Framework
Available since 1.1
Return to top