ScrollBar.SmallChange Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

ScrollBar.cs

Ruft den Wert ab, der zur Value-Eigenschaft addiert oder von dieser subtrahiert werden soll, wenn das Bildlauffeld um eine kleine Strecke verschoben wird, oder legt diesen fest.

public:
 property int SmallChange { int get(); void set(int value); };

public int SmallChange { get; set; }

member this.SmallChange : int with get, set

Public Property SmallChange As Integer

Eigenschaftswert

Int32

Ein numerischer Wert. Der Standardwert ist 1.

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Wert ist kleiner als 0.

Beispiele

Im folgenden Beispiel wird davon ausgegangen, dass Sie einen Formerstellt haben, dem ein PictureBox hinzugefügt und dem Formeine horizontale HScrollBar und eine vertikale VScrollBar hinzugefügt haben PictureBox. Dieses Codebeispiel ist Teil eines größeren Beispiels für die ScrollBar Klassenübersicht.

In diesem Beispiel wird die SmallChange -Eigenschaft relativ zur Größe von PictureBoxfestgelegt.

Sie müssen Verweise auf die System.Drawing Namespaces und System.Windows.Forms hinzufügen, um dieses Beispiel auszuführen.

Hinweis

Anweisungen zum Ausführen dieses Beispiels in Visual Studio finden Sie unter Vorgehensweise: Kompilieren und Ausführen eines vollständigen Windows Forms Codebeispiels mit Visual Studio.

public void SetScrollBarValues()
{
    //Set the following scrollbar properties:

    //Minimum: Set to 0

    //SmallChange and LargeChange: Per UI guidelines, these must be set
    //    relative to the size of the view that the user sees, not to
    //    the total size including the unseen part.  In this example,
    //    these must be set relative to the picture box, not to the image.

    //Maximum: Calculate in steps:
    //Step 1: The maximum to scroll is the size of the unseen part.
    //Step 2: Add the size of visible scrollbars if necessary.
    //Step 3: Add an adjustment factor of ScrollBar.LargeChange.

    //Configure the horizontal scrollbar
    //---------------------------------------------
    if (this.hScrollBar1.Visible)
    {
        this.hScrollBar1.Minimum = 0;
        this.hScrollBar1.SmallChange = this.pictureBox1.Width / 20;
        this.hScrollBar1.LargeChange = this.pictureBox1.Width / 10;

        this.hScrollBar1.Maximum = this.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width;  //step 1

        if (this.vScrollBar1.Visible) //step 2
        {
            this.hScrollBar1.Maximum += this.vScrollBar1.Width;
        }

        this.hScrollBar1.Maximum += this.hScrollBar1.LargeChange; //step 3
    }

    //Configure the vertical scrollbar
    //---------------------------------------------
    if (this.vScrollBar1.Visible)
    {
        this.vScrollBar1.Minimum = 0;
        this.vScrollBar1.SmallChange = this.pictureBox1.Height / 20;
        this.vScrollBar1.LargeChange = this.pictureBox1.Height / 10;

        this.vScrollBar1.Maximum = this.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height; //step 1

        if (this.hScrollBar1.Visible) //step 2
        {
            this.vScrollBar1.Maximum += this.hScrollBar1.Height;
        }

        this.vScrollBar1.Maximum += this.vScrollBar1.LargeChange; //step 3
    }
}

Public Sub SetScrollBarValues()

    'Set the following scrollbar properties:

    'Minimum: Set to 0

    'SmallChange and LargeChange: Per UI guidelines, these must be set
    '    relative to the size of the view that the user sees, not to
    '    the total size including the unseen part.  In this example,
    '    these must be set relative to the picture box, not to the image.

    'Maximum: Calculate in steps:
    'Step 1: The maximum to scroll is the size of the unseen part.
    'Step 2: Add the size of visible scrollbars if necessary.
    'Step 3: Add an adjustment factor of ScrollBar.LargeChange.


    'Configure the horizontal scrollbar
    '---------------------------------------------
    If (Me.hScrollBar1.Visible) Then

        Me.hScrollBar1.Minimum = 0
        Me.hScrollBar1.SmallChange = CInt(Me.pictureBox1.Width / 20)
        Me.hScrollBar1.LargeChange = CInt(Me.pictureBox1.Width / 10)

        Me.hScrollBar1.Maximum = Me.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width  'step 1

        If (Me.vScrollBar1.Visible) Then 'step 2

            Me.hScrollBar1.Maximum += Me.vScrollBar1.Width
        End If

        Me.hScrollBar1.Maximum += Me.hScrollBar1.LargeChange 'step 3
    End If

    'Configure the vertical scrollbar
    '---------------------------------------------
    If (Me.vScrollBar1.Visible) Then

        Me.vScrollBar1.Minimum = 0
        Me.vScrollBar1.SmallChange = CInt(Me.pictureBox1.Height / 20)
        Me.vScrollBar1.LargeChange = CInt(Me.pictureBox1.Height / 10)

        Me.vScrollBar1.Maximum = Me.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height 'step 1

        If (Me.hScrollBar1.Visible) Then 'step 2

            Me.vScrollBar1.Maximum += Me.hScrollBar1.Height
        End If

        Me.vScrollBar1.Maximum += Me.vScrollBar1.LargeChange 'step 3
    End If
 End Sub

Hinweise

Wenn der Benutzer eine der Pfeiltasten drückt oder auf eine der Schaltflächen der Scrollleiste klickt, ändert sich die Value-Eigenschaft entsprechend dem in der SmallChange-Eigenschaft festgelegten Wert.

Richtlinien für die Benutzeroberfläche schlagen vor, dass die SmallChange Eigenschaften und LargeChange relativ zur Größe der Sicht festgelegt werden, die dem Benutzer angezeigt wird, und nicht auf die Gesamtgröße einschließlich des unsichtbaren Teils. Wenn Sie beispielsweise über ein Bildfeld mit Bildlaufleisten verfügen, die ein großes Bild anzeigen, sollten die SmallChange Eigenschaften und LargeChange relativ zur Größe des Bildfelds und nicht zur Größe des Bilds festgelegt werden.

Weitere Informationen

• LargeChange