ScrollBar.SmallChange ScrollBar.SmallChange ScrollBar.SmallChange ScrollBar.SmallChange Property

Definición

Obtiene o establece el valor que se suma o se resta de la propiedad Value cuando el cuadro de desplazamiento se mueve una distancia pequeña.Gets or sets the value to be added to or subtracted from the Value property when the scroll box is moved a small distance.

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

Valor de propiedad

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

Excepciones

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

Ejemplos

En el ejemplo siguiente Formse da PictureBox por supuesto que ha creado un, ha Formagregado a y PictureBoxha agregado HScrollBar un horizontal y VScrollBar un vertical a.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 ScrollBar para la información general de la clase.This code example is part of a larger example provided for the ScrollBar class overview.

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

Debe agregar referencias a los System.Drawing espacios de nombres 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, consulte cómo: Compile y ejecute un ejemplo de código completo Windows Forms con VisualStudio.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 presiona una de las teclas de dirección o hace clic en uno de los botones de la Value barra de desplazamiento, la propiedad cambia según el SmallChange valor establecido en la propiedad.When the user presses one of the arrow keys or clicks one of the scroll bar buttons, the Value property changes according to the value set in the SmallChange property.

Las instrucciones de la interfaz de SmallChange usuario LargeChange sugieren que las propiedades y se establecen en relación con el tamaño de la vista que ve el usuario, no con el tamaño total, incluida 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 SmallChange , LargeChange las propiedades y deben establecerse en relación con el tamaño del cuadro de imagen, no del 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: