ScrollBar.SmallChange Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert ab, der zur Value-Eigenschaft addiert oder von dieser subtrahiert werden soll, wenn das Bildlauffeld um eine kleine Strecke verschoben wird, oder legt diesen fest.
public:
property int SmallChange { int get(); void set(int value); };public int SmallChange { get; set; }member this.SmallChange : int with get, setPublic Property SmallChange As IntegerEigenschaftswert
Ein numerischer Wert. Der Standardwert ist 1.
Ausnahmen
Der zugewiesene Wert ist kleiner als 0.
Beispiele
Im folgenden Beispiel wird davon ausgegangen, dass Sie einen Formerstellt haben, dem ein PictureBox hinzugefügt und dem Formeine horizontale HScrollBar und eine vertikale VScrollBar hinzugefügt haben PictureBox. Dieses Codebeispiel ist Teil eines größeren Beispiels für die ScrollBar Klassenübersicht.
In diesem Beispiel wird die SmallChange -Eigenschaft relativ zur Größe von PictureBoxfestgelegt.
Sie müssen Verweise auf die System.Drawing Namespaces und System.Windows.Forms hinzufügen, um dieses Beispiel auszuführen.
Hinweis
Anweisungen zum Ausführen dieses Beispiels in Visual Studio finden Sie unter Vorgehensweise: Kompilieren und Ausführen eines vollständigen Windows Forms Codebeispiels mit 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
Hinweise
Wenn der Benutzer eine der Pfeiltasten drückt oder auf eine der Schaltflächen der Scrollleiste klickt, ändert sich die Value-Eigenschaft entsprechend dem in der SmallChange-Eigenschaft festgelegten Wert.
Richtlinien für die Benutzeroberfläche schlagen vor, dass die SmallChange Eigenschaften und LargeChange relativ zur Größe der Sicht festgelegt werden, die dem Benutzer angezeigt wird, und nicht auf die Gesamtgröße einschließlich des unsichtbaren Teils. Wenn Sie beispielsweise über ein Bildfeld mit Bildlaufleisten verfügen, die ein großes Bild anzeigen, sollten die SmallChange Eigenschaften und LargeChange relativ zur Größe des Bildfelds und nicht zur Größe des Bilds festgelegt werden.
