ScrollBar.SmallChange Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaydırma kutusu küçük bir mesafeye taşındığında Value özelliğine eklenecek veya özellikten çıkarılacak değeri alır veya ayarlar.

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

Özellik Değeri

Int32

Sayısal bir değer. Varsayılan değer 1’dir.

Özel durumlar

ArgumentOutOfRangeException

Atanan değer 0'dan küçük.

Örnekler

Aşağıdaki örnekte bir oluşturduğunuz Form, öğesine bir PictureBoxFormeklediğiniz ve öğesine yatay HScrollBar ve dikey VScrollBarPictureBoxeklediğiniz varsayılır. Bu kod örneği, sınıfa genel bakış için ScrollBar sağlanan daha büyük bir örneğin parçasıdır.

Bu örnekte özelliği, SmallChange boyutuna göre ayarlanmıştır PictureBox.

Bu örneği çalıştırmak için System.Drawing ve System.Windows.Forms ad alanlarına başvuru eklemeniz gerekir.

Not

Bu örneği Visual Studio'da çalıştırma hakkında yönergeler için bkz. Nasıl yapılır: Visual Studio Kullanarak Eksiksiz bir Windows Forms Kodu Derleme ve Çalıştırma Örneği.

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

Açıklamalar

Kullanıcı ok tuşlarından birine bastığında veya kaydırma çubuğu düğmelerinden birine tıkladığında, Value özellik özelliğinde SmallChange ayarlanan değere göre değişir.

Kullanıcı arabirimi yönergeleri, ve LargeChange özelliklerinin kullanıcının gördüğü görünümün boyutuna göre ayarlandığını, görünmeyen bölümü de içeren toplam boyuta göre ayarlandığını önerirSmallChange. Örneğin, kaydırma çubuklarının büyük bir görüntü görüntülendiği bir resim kutunuz varsa ve LargeChange özellikleri resmin SmallChange boyutuna göre değil, resim kutusunun boyutuna göre ayarlanmalıdır.

Ayrıca bkz.

• LargeChange