ScrollBar.LargeChange Eigenschap

Definitie

Hiermee wordt een waarde opgehaald of ingesteld die moet worden toegevoegd aan of afgetrokken van de Value eigenschap wanneer het schuifvak een grote afstand wordt verplaatst.

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

Waarde van eigenschap

Een numerieke waarde. De standaardwaarde is 10.

Uitzonderingen

De toegewezen waarde is kleiner dan 0.

Voorbeelden

In het volgende voorbeeld wordt ervan uitgegaan dat u een Form, toegevoegd PictureBox aan de Form, en een horizontale HScrollBar en een verticale VScrollBar aan de PictureBox. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor het ScrollBar klasseoverzicht.

In dit voorbeeld wordt de LargeChange eigenschap ingesteld ten opzichte van de grootte van de PictureBox.

U moet verwijzingen toevoegen naar de System.Drawing en System.Windows.Forms naamruimten om dit voorbeeld uit te voeren.

Note

Zie How to: Compileer and Run a Complete Windows Forms Code Example Using Visual Studio voor instructies over het uitvoeren van dit voorbeeld in 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

Opmerkingen

Wanneer de gebruiker in het schuifbalkspoor aan beide zijden van het schuifvak klikt, wordt de Value eigenschap gewijzigd op basis van de waarde die in de LargeChange eigenschap is ingesteld.

Note

U kunt de toets op gebeurtenissen afhandelen, zodat wanneer de gebruiker op de toets PAGE UP of PAGE DOWN drukt, het schuifvak wordt verplaatst.

Richtlijnen voor de gebruikersinterface stellen voor dat de SmallChange eigenschappen LargeChange zijn ingesteld ten opzichte van de grootte van de weergave die de gebruiker ziet, niet op de totale grootte, inclusief het ongelezen deel. Als u bijvoorbeeld een afbeeldingsvak hebt met schuifbalken met een grote afbeelding, moeten de SmallChange en LargeChange eigenschappen worden ingesteld ten opzichte van de grootte van het afbeeldingsvak, niet op de grootte van de afbeelding.

Van toepassing op

Zie ook