ScrollBar.LargeChange Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.