ScrollBar.LargeChange Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab, der zur Value-Eigenschaft addiert oder von dieser subtrahiert werden soll, wenn das Bildlauffeld um einen größeren Abstand verschoben wird, oder legt diesen fest.

public:
 property int LargeChange { int get(); void set(int value); };
public int LargeChange { get; set; }
member this.LargeChange : int with get, set
Public Property LargeChange As Integer

Eigenschaftswert

Int32

Ein numerischer Wert. Der Standardwert ist 10.

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Wert ist kleiner als 0.

Beispiele

Im folgenden Beispiel wird davon ausgegangen, dass Sie einen Form, dem eine PictureBox Formhinzugefügt haben, und eine horizontale HScrollBar und eine vertikale VScrollBar Dem PictureBoxhinzugefügt haben. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ScrollBar Klassenübersicht bereitgestellt wird.

In diesem Beispiel wird die LargeChange Eigenschaft relativ zur Größe der PictureBox.

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

Hinweis

Anweisungen zum Ausführen dieses Beispiels in Visual Studio finden Sie unter How to: 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 auf die Bildlaufleistenspur auf einer der Seiten des Bildlauffelds klickt, ändert sich die Value Eigenschaft entsprechend dem in der LargeChange Eigenschaft festgelegten Wert.

Hinweis

Sie können Tastendruckereignisse behandeln, sodass der Benutzer beim Drücken der BILD-NACH-OBEN- oder BILD-NACH-UNTEN-TASTE das Bildlauffeld bewegt.

Richtlinien für die Benutzeroberfläche deuten darauf hin, dass die SmallChange Eigenschaften LargeChange relativ zur Größe der Ansicht festgelegt werden, die der Benutzer sieht, nicht auf die Gesamtgröße einschließlich des nicht angezeigten Teils. Wenn Sie beispielsweise über ein Bildfeld mit Bildlaufleisten verfügen, die ein großes Bild anzeigen, sollten die SmallChange und LargeChange die Eigenschaften relativ zur Größe des Bildfelds festgelegt werden, nicht auf die Größe des Bilds.

Gilt für

Siehe auch