ScrollBar.Value Propriété

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
ScrollBar.cs
Source:
ScrollBar.cs
Source:
ScrollBar.cs
Source:
ScrollBar.cs
Source:
ScrollBar.cs

Obtient ou définit une valeur numérique qui représente la position actuelle de la zone de défilement sur le contrôle de barre de défilement.

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

Valeur de propriété

Int32

Valeur numérique qui se trouve dans la plage et Minimum dans la Maximum plage. La valeur par défaut est 0.

Attributs
BindableAttribute

Exceptions

ArgumentOutOfRangeException

La valeur affectée est inférieure à la valeur de propriété Minimum .

- ou -

La valeur affectée est supérieure à la valeur de propriété Maximum .

Exemples

L’exemple suivant fait défiler une image dans une zone d’image. Il utilise la Value barre de défilement pour redessiner une nouvelle partie de l’image chaque fois que l’utilisateur fait défiler. Cet exemple de code fait partie d’un exemple plus large fourni pour la vue d’ensemble de la ScrollBar classe.

Note

Pour obtenir des instructions sur l’exécution de cet exemple dans Visual Studio, consultez Guide pratique pour compiler et exécuter un exemple complet de code Windows Forms à l’aide de 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

S’applique à