NumericUpDown.Increment Propriedade

Definição

Obtém ou define o valor para incrementar ou decrementar a caixa de rotação (também conhecida como um controle superior/inferior) quando um usuário clicar nos botões superiores/inferiores.

public decimal Increment { get; set; }

Valor da propriedade

O valor para incrementar ou decrementar a propriedade Value quando um usuário clicar nos botões superiores/inferiores na caixa de rotação. O valor padrão é 1.

Exceções

O valor atribuído não é maior ou igual a zero.

Exemplos

O exemplo de código a seguir cria e inicializa um NumericUpDown controle, define algumas de suas propriedades comuns e permite que o usuário altere algumas dessas propriedades em tempo de execução. Esse código pressupõe que três CheckBox controles foram colocados em um formulário e os manipuladores para seus Click eventos foram instanciados. As DecimalPlacespropriedades , ThousandsSeparatore Hexadecimal são definidas no Click evento de cada marcar caixa.

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;
   }
}

Comentários

Clicar no botão para cima faz com que a Value propriedade incremente pelo valor especificado pela Increment propriedade e se aproxime da Maximum propriedade. Clicar no botão para baixo faz com que a Value propriedade seja decrementada pelo valor especificado pela Increment propriedade e se aproxime da Minimum propriedade.

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Confira também