ScrollBar.Value プロパティ


スクロール バー コントロールのスクロール ボックスの現在位置を表す数値を取得または設定します。Gets or sets a numeric value that represents the current position of the scroll box on the scroll bar control.

 property int Value { int get(); void set(int value); };
public int Value { get; set; }
member this.Value : int with get, set
Public Property Value As Integer


MinimumMaximum の範囲内の数値。A numeric value that is within the Minimum and Maximum range. 既定値は 0 です。The default value is 0.



代入された値は Minimum プロパティ値未満です。The assigned value is less than the Minimum property value.

または-or- 代入された値が Maximum プロパティ値より大きいです。The assigned value is greater than the Maximum property value.

次の例では、ピクチャボックス内の画像をスクロールします。The following example scrolls an image in a picture box. スクロールバーの Value を使用して、ユーザーがスクロールするたびにイメージの新しい部分を再描画します。It uses the Value of the scrollbar to redraw a new part of the image whenever the user scrolls. このコード例は、ScrollBar クラスの概要に用意されている大規模な例の一部です。This code example is part of a larger example provided for the ScrollBar class overview.


Visual Studio でこの例を実行する手順については、「方法: Visual Studio を使用して完全な Windows フォームコード例をコンパイルして実行する」を参照してください。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

Private Sub HandleScroll(ByVal sender As [Object], ByVal e As ScrollEventArgs) _
  Handles vScrollBar1.Scroll, hScrollBar1.Scroll

    'Create a graphics object and draw a portion of the image in the PictureBox.
    Dim g As Graphics = pictureBox1.CreateGraphics()

    Dim xWidth As Integer = pictureBox1.Width
    Dim yHeight As Integer = pictureBox1.Height

    Dim x As Integer
    Dim y As Integer

    If (e.ScrollOrientation = ScrollOrientation.HorizontalScroll) Then

        x = e.NewValue
        y = vScrollBar1.Value

    Else 'e.ScrollOrientation == ScrollOrientation.VerticalScroll

        y = e.NewValue
        x = hScrollBar1.Value
    End If

    'First Rectangle: Where to draw the image.
    'Second Rectangle: The portion of the image to draw.

    g.DrawImage(pictureBox1.Image, _
      New Rectangle(0, 0, xWidth, yHeight), _
      New Rectangle(x, y, xWidth, yHeight), _

End Sub