Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Classe NumericUpDown
Collapse the table of content
Expand the table of content
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe NumericUpDown

Representa uma caixa de rotação do Windows (também conhecido sistema autônomo um controle acima-abaixo) que exibe valores numéricos.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

[ComVisibleAttribute(true)]
[DefaultBindingPropertyAttribute("Value")]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class NumericUpDown : UpDownBase, 
	ISupportInitialize

A NumericUpDown controle contém um único valor numérico que pode ser incrementado ou diminuído, clicando em cima ou para baixo de botões do controle. O usuário também pode inserir em um valor, a menos que o ReadOnly propriedade é conjunto para true.

Exibição numérica pode ser formatada, definindo o DecimalPlaces, Hexadecimal, ou ThousandsSeparator Propriedades. Para exibir valores hexadecimais do controle, conjunto o Hexadecimal propriedade para true. Para exibir um milhares separador em números Decimal quando apropriado, conjunto o ThousandsSeparator propriedade para true. Para especificar o número de dígitos exibidos após o símbolo decimal, defina o DecimalPlaces propriedade para o número de casas decimais a serem exibidas.

Para especificar o intervalo de valores para o controle permitido conjunto o Minimum e Maximum Propriedades. conjunto o Increment valor para especificar o valor seja incrementado ou diminuído para a Value propriedade quando o usuário clica em cima ou para baixo de botões de seta. Você pode aumentar a velocidade que o controle move através de um número quando o usuário pressiona continuamente cima ou seta para baixo, definindo o Accelerations propriedade.

Quando o UpButton ou DownButton os métodos são chamados, no código ou com o clicar de cima ou para baixo de botões, o novo valor é validado e o controle é atualizado com o novo valor no formato apropriado. Especificamente, se o UserEdit propriedade é conjunto para true, o ParseEditText método é chamado antes para validar ou atualizar o valor. O valor é verificado estar entre o Minimum e Maximum valores e o UpdateEditText método é chamado.

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 alterar algumas dessas propriedades em time de execução. Esse código supõe três CheckBox controles foram colocados em um formulário e manipuladores para os seus Click eventos tem sido instanciados. The DecimalPlaces, ThousandsSeparator, e Hexadecimal as propriedades são conjunto sobre o Click evento de cada caixa de seleção.

publicvoid 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.privatevoid 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.privatevoid 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.privatevoid 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.set_Dock(System.Windows.Forms.DockStyle.Top);

    // Set the Minimum, Maximum, and initial Value.
    numericUpDown1.set_Value(System.Convert.ToDecimal(5));
    numericUpDown1.set_Maximum(System.Convert.ToDecimal(2500));
    numericUpDown1.set_Minimum(System.Convert.ToDecimal(-100));

    // Add the NumericUpDown to the Form.
    get_Controls().Add(numericUpDown1);
} //InstantiateMyNumericUpDown

// 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.get_DecimalPlaces() > 0) {
        numericUpDown1.set_DecimalPlaces(0);
        numericUpDown1.set_Value(Decimal.Round
            (numericUpDown1.get_Value(), 0));
    }
    else {
        numericUpDown1.set_DecimalPlaces(2);
        numericUpDown1.set_Increment(System.Convert.ToDecimal((0.25)));
    }
} //checkBox1_Click

// 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.get_ThousandsSeparator()) {
        numericUpDown1.set_ThousandsSeparator(false);
    }
    else {
        numericUpDown1.set_ThousandsSeparator(true);
    }
} //checkBox2_Click

// 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.get_Hexadecimal()) {
        numericUpDown1.set_Hexadecimal(false);
    }
    else {
        numericUpDown1.set_Hexadecimal(true);
    }
} //checkBox3_Click


Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Pocket PC

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatível com: 3.5, 2.0, 1.0

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft