ScrollBar.LargeChange Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ScrollBar.cs

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

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

Özellik Değeri

Int32

Sayısal bir değer. Varsayılan değer 10'dur.

Ö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, LargeChange boyutuna PictureBoxgöre ayarlanır.

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

Uyarı

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ı kaydırma kutusunun her iki tarafındaki kaydırma çubuğu izlemesine tıkladığında, Value özellik özelliğinde LargeChange ayarlanan değere göre değişir.

Uyarı

Kullanıcı PAGE UP veya PAGE DOWN tuşuna bastığında kaydırma kutusunun hareket edebilmesi için tuşa basma olaylarını işleyebilirsiniz.

Kullanıcı arabirimi yönergeleri, ve LargeChange özelliklerinin görünmeyen bölüm de dahil olmak üzere toplam boyuta değil, kullanıcının gördüğü görünümün boyutuna göre ayarlandığını önerirSmallChange. Örneğin, büyük bir resim görüntüleyen kaydırma çubukları içeren 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.

• SmallChange