ScrollBar.Value Eigenschap

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Bron:
ScrollBar.cs
Bron:
ScrollBar.cs
Bron:
ScrollBar.cs
Bron:
ScrollBar.cs
Bron:
ScrollBar.cs

Hiermee wordt een numerieke waarde opgehaald of ingesteld die de huidige positie van het schuifvak aangeeft op het besturingselement voor de schuifbalk.

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

Waarde van eigenschap

Int32

Een numerieke waarde die zich binnen het Minimum bereik bevindt Maximum . De standaardwaarde is 0.

Kenmerken
BindableAttribute

Uitzonderingen

ArgumentOutOfRangeException

De toegewezen waarde is kleiner dan de Minimum eigenschapswaarde.

– of –

De toegewezen waarde is groter dan de Maximum eigenschapswaarde.

Voorbeelden

In het volgende voorbeeld wordt een afbeelding in een afbeeldingsvak geschoven. Er wordt gebruikgemaakt van de Value schuifbalk om een nieuw deel van de afbeelding opnieuw te tekenen wanneer de gebruiker schuift. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor het ScrollBar klasseoverzicht.

Note

Zie How to: Compileer and Run a Complete Windows Forms Code Example Using Visual Studio voor instructies over het uitvoeren van dit voorbeeld in 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

Van toepassing op