ScrollBar.Value Propiedad

Definición

Obtiene o establece un valor numérico que representa la posición actual del cuadro de desplazamiento en el control de barra de desplazamiento.Gets or sets a numeric value that represents the current position of the scroll box on the scroll bar control.

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

Valor de propiedad

Valor numérico comprendido en el intervalo Minimum y Maximum.A numeric value that is within the Minimum and Maximum range. El valor predeterminado es 0.The default value is 0.

Atributos

Excepciones

El valor asignado es menor que el valor de la propiedad Minimum.The assigned value is less than the Minimum property value.

o bien-or- El valor asignado es mayor que el valor de la propiedad Maximum.The assigned value is greater than the Maximum property value.

Ejemplos

En el ejemplo siguiente se desplaza una imagen en un cuadro de imagen.The following example scrolls an image in a picture box. Utiliza el Value de la barra de desplazamiento para volver a dibujar una nueva parte de la imagen cada vez que el usuario se desplaza.It uses the Value of the scrollbar to redraw a new part of the image whenever the user scrolls. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para la información general de la clase ScrollBar.This code example is part of a larger example provided for the ScrollBar class overview.

Nota

Para obtener instrucciones sobre cómo ejecutar este ejemplo en Visual Studio, vea [How para: Compile y ejecute un ejemplo de código completo Windows Forms con Visual Studio @ no__t-0.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();
}
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

Se aplica a