ScrollBar.Maximum Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ScrollBar.cs

Kaydırılabilir aralığın değer üst sınırını alır veya ayarlar.

public:
 property int Maximum { int get(); void set(int value); };

public int Maximum { get; set; }

member this.Maximum : int with get, set

Public Property Maximum As Integer

Özellik Değeri

Int32

Sayısal bir değer. Varsayılan değer 100 şeklindedir.

Ö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 özellik, Maximum görünür durumdaysa kaydırma çubuğunun Image boyutuna ek olarak özelliğin boyutunun LargeChange ayarlama faktörü olarak 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

Özelliği, piksel boyutuyla orantılı olarak kaydırma çubuğunun üst öğesinin boyutuyla veya görüntülenen satır veya çizgi sayısıyla eşleşecek şekilde dinamik olarak ayarlamayı Maximum düşünebilirsiniz.

En büyük değere yalnızca program aracılığıyla ulaşılabilir. Kaydırma çubuğunun değeri, çalışma zamanında kullanıcı etkileşimi aracılığıyla en yüksek değerine ulaşamaz. Kullanıcı etkileşimi aracılığıyla ulaşabileceğiniz en büyük değer 1'e eşittir ve Maximum özellik değeri eksi LargeChange özellik değeridir. Gerekirse, özelliğini 1 terimini hesaba -1 nesnenin boyutuna ayarlayabilirsiniz Maximum .

Ayrıca bkz.

• Minimum