ScrollBar.LargeChange Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

ScrollBar.cs

Obtiene o establece un valor al que se va a agregar o restar de la Value propiedad cuando el cuadro de desplazamiento se mueve a una distancia grande.

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

Valor de propiedad

Int32

Un valor numérico. El valor predeterminado es 10.

Excepciones

ArgumentOutOfRangeException

El valor asignado es menor que 0.

Ejemplos

En el ejemplo siguiente se supone que ha creado un Form, se ha agregado un PictureBox objeto a Formy se ha agregado una horizontal HScrollBar y una vertical VScrollBar a PictureBox. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la información general de la ScrollBar clase.

En este ejemplo, la LargeChange propiedad se establece en relación con el tamaño de PictureBox.

Debe agregar referencias a los System.Drawing espacios de nombres y System.Windows.Forms para ejecutar este ejemplo.

Nota:

Para obtener instrucciones sobre cómo ejecutar este ejemplo en Visual Studio, vea How to: Compile and Run a Complete Windows Forms Code Example using Visual Studio (Cómo: Compilar y ejecutar un ejemplo completo de código de Windows Forms con 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

Comentarios

Cuando el usuario hace clic en la pista de la barra de desplazamiento en cualquiera de los lados del cuadro de desplazamiento, la Value propiedad cambia según el valor establecido en la LargeChange propiedad .

Nota:

Puede controlar los eventos de pulsación de teclas para que cuando el usuario presione la tecla PAGE UP o PAGE DOWN, el cuadro de desplazamiento se mueve.

Las instrucciones de la interfaz de usuario sugieren que las SmallChange propiedades y LargeChange se establecen con respecto al tamaño de la vista que ve el usuario, no al tamaño total, incluido el elemento no visible. Por ejemplo, si tiene un cuadro de imagen con barras de desplazamiento que muestran una imagen grande, las SmallChange propiedades y LargeChange deben establecerse en relación con el tamaño del cuadro de imagen, no con el tamaño de la imagen.

Consulte también

• SmallChange