ScrollBar.Value Właściwość

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll
Źródło:
ScrollBar.cs
Źródło:
ScrollBar.cs
Źródło:
ScrollBar.cs
Źródło:
ScrollBar.cs
Źródło:
ScrollBar.cs

Pobiera lub ustawia wartość liczbową reprezentującą bieżące położenie pola przewijania w kontrolce paska przewijania.

public:
 property int Value { int get(); void set(int value); };
[System.ComponentModel.Bindable(true)]
public int Value { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Value : int with get, set
Public Property Value As Integer

Wartość właściwości

Int32

Wartość liczbowa, która znajduje się w zakresie Minimum i Maximum . Wartość domyślna to 0.

Atrybuty
BindableAttribute

Wyjątki

ArgumentOutOfRangeException

Przypisana wartość jest mniejsza niż Minimum wartość właściwości.

— lub —

Przypisana wartość jest większa niż Maximum wartość właściwości.

Przykłady

Poniższy przykład przewija obraz w polu obrazu. Używa Value paska przewijania do ponownego rysowania nowej części obrazu za każdym razem, gdy użytkownik przewija. Ten przykład kodu jest częścią większego przykładu udostępnionego ScrollBar dla przeglądu klasy.

Note

Aby uzyskać instrukcje dotyczące uruchamiania tego przykładu w programie Visual Studio, zobacz How to: Compile and Run a Complete Windows Forms Code Example Using Visual Studio (Instrukcje: kompilowanie i uruchamianie kompletnego kodu formularzy systemu Windows przy użyciu programu 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();
}

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), _
      GraphicsUnit.Pixel)

    pictureBox1.Update()
End Sub

Dotyczy