ScrollBar.Value Property
Gets or sets a numeric value that represents the current position of the scroll box on the scroll bar control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The assigned value is less than the Minimum property value. -or- 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.
 Note |
|---|
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; } 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(); }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
