NumericUpDown.Increment 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.
Dient zum Abrufen oder Festlegen des Werts, um das Drehfeld (auch als Nach-unten-Steuerelement bezeichnet) zu erhöhen oder zu verringern, wenn auf die Schaltflächen nach oben oder unten geklickt werden.
public:
property System::Decimal Increment { System::Decimal get(); void set(System::Decimal value); };public decimal Increment { get; set; }member this.Increment : decimal with get, setPublic Property Increment As DecimalEigenschaftswert
Der Wert, der Value inkrementiert oder verringert werden soll, wenn die Schaltflächen nach oben oder unten auf das Drehfeld geklickt werden. Der Standardwert ist 1.
Ausnahmen
Der zugewiesene Wert ist nicht größer oder gleich Null.
Beispiele
Das folgende Codebeispiel erstellt und initialisiert ein NumericUpDown Steuerelement, legt einige seiner allgemeinen Eigenschaften fest und ermöglicht es dem Benutzer, einige dieser Eigenschaften zur Laufzeit zu ändern. In diesem Code wird davon ausgegangen, dass drei CheckBox Steuerelemente auf einem Formular und Handlern für ihre Click Ereignisse instanziiert wurden. Die DecimalPlacesEigenschaften und Die Hexadecimal Eigenschaften ThousandsSeparatorwerden für das Click Ereignis jedes Kontrollkästchens festgelegt.
public:
void InstantiateMyNumericUpDown()
{
// Create and initialize a NumericUpDown control.
numericUpDown1 = gcnew NumericUpDown;
// Dock the control to the top of the form.
numericUpDown1->Dock = System::Windows::Forms::DockStyle::Top;
// Set the Minimum, Maximum, and initial Value.
numericUpDown1->Value = 5;
numericUpDown1->Maximum = 2500;
numericUpDown1->Minimum = -100;
// Add the NumericUpDown to the Form.
Controls->Add( numericUpDown1 );
}
private:
// Check box to toggle decimal places to be displayed.
void checkBox1_Click( Object^ sender, EventArgs^ e )
{
/* If DecimalPlaces is greater than 0, set them to 0 and round the
current Value; otherwise, set DecimalPlaces to 2 and change the
Increment to 0.25. */
if ( numericUpDown1->DecimalPlaces > 0 )
{
numericUpDown1->DecimalPlaces = 0;
numericUpDown1->Value = Decimal::Round( numericUpDown1->Value, 0 );
}
else
{
numericUpDown1->DecimalPlaces = 2;
numericUpDown1->Increment = Decimal(0.25);
}
}
// Check box to toggle thousands separators to be displayed.
void checkBox2_Click( Object^ sender, EventArgs^ e )
{
/* If ThousandsSeparator is true, set it to false;
otherwise, set it to true. */
if ( numericUpDown1->ThousandsSeparator )
{
numericUpDown1->ThousandsSeparator = false;
}
else
{
numericUpDown1->ThousandsSeparator = true;
}
}
// Check box to toggle hexadecimal to be displayed.
void checkBox3_Click( Object^ sender, EventArgs^ e )
{
/* If Hexadecimal is true, set it to false;
otherwise, set it to true. */
if ( numericUpDown1->Hexadecimal )
{
numericUpDown1->Hexadecimal = false;
}
else
{
numericUpDown1->Hexadecimal = true;
}
}
public void InstantiateMyNumericUpDown()
{
// Create and initialize a NumericUpDown control.
numericUpDown1 = new NumericUpDown();
// Dock the control to the top of the form.
numericUpDown1.Dock = System.Windows.Forms.DockStyle.Top;
// Set the Minimum, Maximum, and initial Value.
numericUpDown1.Value = 5;
numericUpDown1.Maximum = 2500;
numericUpDown1.Minimum = -100;
// Add the NumericUpDown to the Form.
Controls.Add(numericUpDown1);
}
// Check box to toggle decimal places to be displayed.
private void checkBox1_Click(Object sender,
EventArgs e)
{
/* If DecimalPlaces is greater than 0, set them to 0 and round the
current Value; otherwise, set DecimalPlaces to 2 and change the
Increment to 0.25. */
if (numericUpDown1.DecimalPlaces > 0)
{
numericUpDown1.DecimalPlaces = 0;
numericUpDown1.Value = Decimal.Round(numericUpDown1.Value, 0);
}
else
{
numericUpDown1.DecimalPlaces = 2;
numericUpDown1.Increment = 0.25M;
}
}
// Check box to toggle thousands separators to be displayed.
private void checkBox2_Click(Object sender,
EventArgs e)
{
/* If ThousandsSeparator is true, set it to false;
otherwise, set it to true. */
if (numericUpDown1.ThousandsSeparator)
{
numericUpDown1.ThousandsSeparator = false;
}
else
{
numericUpDown1.ThousandsSeparator = true;
}
}
// Check box to toggle hexadecimal to be displayed.
private void checkBox3_Click(Object sender,
EventArgs e)
{
/* If Hexadecimal is true, set it to false;
otherwise, set it to true. */
if (numericUpDown1.Hexadecimal)
{
numericUpDown1.Hexadecimal = false;
}
else
{
numericUpDown1.Hexadecimal = true;
}
}
Public Sub InstantiateMyNumericUpDown()
' Create and initialize a NumericUpDown control.
numericUpDown1 = New NumericUpDown()
' Dock the control to the top of the form.
numericUpDown1.Dock = System.Windows.Forms.DockStyle.Top
' Set the Minimum, Maximum, and initial Value.
numericUpDown1.Value = 5
numericUpDown1.Maximum = 2500
numericUpDown1.Minimum = - 100
' Add the NumericUpDown to the Form.
Controls.Add(numericUpDown1)
End Sub
' Check box to toggle decimal places to be displayed.
Private Sub checkBox1_Click(sender As Object, e As EventArgs)
' If DecimalPlaces is greater than 0, set them to 0 and round the
' current Value; otherwise, set DecimalPlaces to 2 and change the
' Increment to 0.25.
If numericUpDown1.DecimalPlaces > 0 Then
numericUpDown1.DecimalPlaces = 0
numericUpDown1.Value = Decimal.Round(numericUpDown1.Value, 0)
Else
numericUpDown1.DecimalPlaces = 2
numericUpDown1.Increment = 0.25D
End If
End Sub
' Check box to toggle thousands separators to be displayed.
Private Sub checkBox2_Click(sender As Object, e As EventArgs)
' If ThousandsSeparator is true, set it to false;
' otherwise, set it to true.
If numericUpDown1.ThousandsSeparator Then
numericUpDown1.ThousandsSeparator = False
Else
numericUpDown1.ThousandsSeparator = True
End If
End Sub
' Check box to toggle hexadecimal to be displayed.
Private Sub checkBox3_Click(sender As Object, e As EventArgs)
' If Hexadecimal is true, set it to false;
' otherwise, set it to true.
If numericUpDown1.Hexadecimal Then
numericUpDown1.Hexadecimal = False
Else
numericUpDown1.Hexadecimal = True
End If
End Sub
Hinweise
Durch Klicken auf die Schaltfläche "Aufwärts" wird die Value Eigenschaft um den durch die Increment Eigenschaft angegebenen Betrag erhöht und die Maximum Eigenschaft nähert. Wenn Sie auf die Schaltfläche nach unten klicken, wird die Value Eigenschaft um den durch die Increment Eigenschaft angegebenen Betrag erhöht und die Minimum Eigenschaft nähert.
