ScrollBar.LargeChange ScrollBar.LargeChange ScrollBar.LargeChange ScrollBar.LargeChange Property

Definición

Obtiene o establece un valor que se suma o se resta de la propiedad Value cuando el cuadro de desplazamiento se mueve una distancia grande.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

Valor de propiedad

Valor numérico.A numeric value. El valor predeterminado es 10.The default value is 10.

Excepciones

El valor asignado es menor que 0.The assigned value is less than 0.

Ejemplos

En el ejemplo siguiente se da por supuesto que ha creado un Form, ha agregado un PictureBox al Form y ha agregado un HScrollBar horizontal y un @no__t vertical-4 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. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para la información general de la clase ScrollBar.This code example is part of a larger example provided for the ScrollBar class overview.

En este ejemplo, la propiedad LargeChange se establece en relación con el tamaño del PictureBox.In this example, the LargeChange property is set relative to the size of the PictureBox.

Debe agregar referencias a los espacios de nombres System.Drawing y System.Windows.Forms para ejecutar este ejemplo.You must add references to the System.Drawing and System.Windows.Forms namespaces to run this example.

Nota

Para obtener instrucciones sobre cómo ejecutar este ejemplo en Visual Studio, vea [How para: Compile y ejecute un ejemplo de código completo Windows Forms con Visual Studio @ no__t-0.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

Comentarios

Cuando el usuario hace clic en la pista de la barra de desplazamiento en cualquier lado del cuadro de desplazamiento, la propiedad Value cambia según el valor establecido en la propiedad 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

Puede controlar los eventos de presión de teclas para que cuando el usuario presione la tecla RE PÁG o Av Pág se mueva el cuadro de desplazamiento.You can handle key press events so that when the user presses the PAGE UP or PAGE DOWN key the scroll box moves.

Las directrices de la interfaz de usuario sugieren que las propiedades SmallChange y LargeChange se establecen en relación con el tamaño de la vista que ve el usuario, no en el tamaño total que incluye la parte no visible.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. Por ejemplo, si tiene un cuadro de imagen con barras de desplazamiento que muestran una imagen grande, las propiedades SmallChange y LargeChange deben establecerse en relación con el tamaño del cuadro de imagen, no con el tamaño de la imagen.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.

Se aplica a

Consulte también: