ScrollBar.Maximum Proprietà

Definizione

Ottiene o imposta il limite superiore dei valori dell'intervallo di scorrimento.Gets or sets the upper limit of values of the scrollable range.

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

Valore della proprietà

valore numerico.A numeric value. Il valore predefinito è 100.The default value is 100.

Esempi

Nell'esempio seguente si presuppone che sia stato creato un Form, aggiunto un PictureBox al Forme che sia stato aggiunto un HScrollBar orizzontale e un VScrollBar verticale al PictureBox.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. Questo esempio di codice fa parte di un esempio più ampio fornito per la panoramica della classe ScrollBar.This code example is part of a larger example provided for the ScrollBar class overview.

In questo esempio, la proprietà Maximum è impostata sulle dimensioni del Image più le dimensioni della barra di scorrimento se è visibile e un fattore di regolazione della dimensione della proprietà LargeChange.In this example, the Maximum property is set to the size of the Image plus the size of the scrollbar if it is visible plus an adjustment factor of the size of the LargeChange property.

Per eseguire questo esempio, è necessario aggiungere riferimenti agli spazi dei nomi System.Drawing e System.Windows.Forms.You must add references to the System.Drawing and System.Windows.Forms namespaces to run this example.

Nota

Per istruzioni su come eseguire questo esempio in Visual Studio, vedere procedura: compilare ed eseguire un esempio di codice di Windows Forms completo con Visual Studio.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

Commenti

È possibile modificare dinamicamente la proprietà Maximum in modo che corrisponda alla dimensione dell'elemento padre della barra di scorrimento in proporzione alle dimensioni del pixel o al numero di righe o righe visualizzate.You might consider adjusting the Maximum property dynamically to match the size of the scroll bar's parent in proportion to pixel size or to the number of rows or lines displayed.

Il valore massimo può essere raggiunto solo a livello di codice.The maximum value can only be reached programmatically. Il valore di una barra di scorrimento non può raggiungere il valore massimo tramite l'interazione dell'utente in fase di esecuzione.The value of a scroll bar cannot reach its maximum value through user interaction at run time. Il valore massimo che è possibile raggiungere tramite l'interazione dell'utente è pari a 1 e il valore della proprietà Maximum meno il valore della proprietà LargeChange.The maximum value that can be reached through user interaction is equal to 1 plus the Maximum property value minus the LargeChange property value. Se necessario, è possibile impostare la proprietà Maximum sulla dimensione dell'oggetto-1 per tenere conto del termine 1.If necessary, you can set the Maximum property to the size of the object -1 to account for the term of 1.

Si applica a

Vedi anche