ScrollBar.LargeChange Proprietà

Definizione

Ottiene o imposta un valore da aggiungere o sottrarre alla proprietà Value quando la casella di scorrimento subisce uno spostamento notevole.Gets or sets a value to be added to or subtracted from the Value property when the scroll box is moved a large distance.

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

Valore della proprietà

valore numerico.A numeric value. Il valore predefinito è 10.The default value is 10.

Eccezioni

Il valore assegnato è minore di 0.The assigned value is less than 0.

Esempio

Nell'esempio seguente si presuppone che sia stato creato un Form, aggiunto un PictureBox al Forme che sia stato aggiunto un HScrollBar orizzontale e un VScrollBar verticale al PictureBox.The following example assumes that you have created a Form, added a PictureBox to the Form, and added a horizontal HScrollBar and a vertical VScrollBar to the PictureBox. Questo esempio di codice fa parte di un esempio più ampio fornito per la panoramica della classe ScrollBar.This code example is part of a larger example provided for the ScrollBar class overview.

In questo esempio, la proprietà LargeChange viene impostata in relazione alle dimensioni del PictureBox.In this example, the LargeChange property is set relative to the size of the PictureBox.

Per eseguire questo esempio, è necessario aggiungere riferimenti agli spazi dei nomi System.Drawing e System.Windows.Forms.You must add references to the System.Drawing and System.Windows.Forms namespaces to run this example.

Nota

Per istruzioni su come eseguire questo esempio in Visual Studio, vedere procedura: compilare ed eseguire un esempio di codice di Windows Forms completo con Visual Studio.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.

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

Commenti

Quando l'utente fa clic sull'indicatore di avanzamento della barra di scorrimento su entrambi i lati della casella di scorrimento, la proprietà Value cambia in base al valore impostato nella proprietà LargeChange.When the user clicks in the scroll bar track on either side of the scroll box, the Value property changes according to the value set in the LargeChange property.

Nota

È possibile gestire gli eventi di pressione dei tasti in modo che quando l'utente preme il tasto PGSU o PGGIÙ la casella di scorrimento viene spostata.You can handle key press events so that when the user presses the PAGE UP or PAGE DOWN key the scroll box moves.

Le linee guida dell'interfaccia utente indicano che le proprietà SmallChange e LargeChange sono impostate in relazione alla dimensione della visualizzazione visualizzata dall'utente, non alle dimensioni totali, inclusa la parte non visibile.User interface guidelines suggest that the SmallChange and LargeChange properties are set relative to the size of the view that the user sees, not to the total size including the unseen part. Ad esempio, se si dispone di una casella immagine con barre di scorrimento che visualizzano un'immagine di grandi dimensioni, è necessario impostare le proprietà SmallChange e LargeChange rispetto alla dimensione della casella immagine, non alla dimensione dell'immagine.For example, if you have a picture box with scroll bars displaying a large image, the SmallChange and LargeChange properties should be set relative to the size of the picture box, not to the size of the image.

Si applica a

Vedi anche