ScrollBar.Value Eigenschaft

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Dient zum Abrufen oder Festlegen eines numerischen Werts, der die aktuelle Position des Bildlauffelds im Bildlaufleisten-Steuerelement darstellt.

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

Eigenschaftswert

Int32

Ein numerischer Wert, der sich innerhalb des Minimum Bereichs befindet Maximum . Der Standardwert ist 0.

Attribute
BindableAttribute

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Wert ist kleiner als der Minimum Eigenschaftswert.

-oder-

Der zugewiesene Wert ist größer als der Maximum Eigenschaftswert.

Beispiele

Im folgenden Beispiel wird ein Bild in einem Bildfeld gescrollt. Es verwendet die Value Bildlaufleiste, um einen neuen Teil des Bilds neu zu zeichnen, wenn der Benutzer scrollt. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ScrollBar Klassenübersicht bereitgestellt wird.

Note

Anweisungen zum Ausführen dieses Beispiels in Visual Studio finden Sie unter 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();
}

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

Gilt für: