ScrollBar.Maximum Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia górny limit wartości zakresu przewijania.

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

Wartość właściwości

Int32

Wartość liczbowa. Wartość domyślna to 100.

Przykłady

W poniższym przykładzie założono, że utworzono element Form, dodany PictureBox do Formelementu , i dodano poziomą i pionową VScrollBarHScrollBar do elementu PictureBox. Ten przykład kodu jest częścią większego przykładu podanego ScrollBar na potrzeby przeglądu klasy.

W tym przykładzie Maximum właściwość jest ustawiona na rozmiar Image plus rozmiar paska przewijania, jeśli jest widoczny oraz współczynnik korekty rozmiaru LargeChange właściwości.

Aby uruchomić ten przykład, należy dodać odwołania do System.Drawing przestrzeni nazw i System.Windows.Forms .

Uwaga

Aby uzyskać instrukcje dotyczące uruchamiania tego przykładu w programie Visual Studio, zobacz How to: Compile and Run a Complete Windows Forms Code Example Using Visual Studio (Instrukcje: kompilowanie i uruchamianie kompletnego Windows Forms przykładu kodu przy użyciu programu 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

Uwagi

Możesz rozważyć dynamiczne dostosowanie Maximum właściwości w celu dopasowania rozmiaru elementu nadrzędnego paska przewijania proporcjonalnie do rozmiaru piksela lub liczby wyświetlanych wierszy lub wierszy.

Maksymalną wartość można osiągnąć tylko programowo. Wartość paska przewijania nie może osiągnąć maksymalnej wartości za pośrednictwem interakcji użytkownika w czasie wykonywania. Maksymalna wartość, którą można uzyskać za pośrednictwem interakcji użytkownika, jest równa 1 plus wartość właściwości pomniejszona Maximum o LargeChange wartość właściwości. W razie potrzeby można ustawić Maximum właściwość na rozmiar obiektu -1, aby uwzględnić termin 1.

Zobacz też

• Minimum