Visão geral do controle NumericUpDown (Windows Forms)

O NumericUpDown controle parece uma combinação de uma caixa de texto e um par de setas que o usuário pode clicar para ajustar um valor. O controle exibe e define um único valor numérico de uma lista de opções fixas de valor numérico. O usuário pode aumentar e diminuir o número clicando nas setas para cima e para baixo, pressionando as teclas Seta Para Cima e Seta Para Baixo, ou digitando um número na caixa de texto do controle. Clicar na tecla seta para cima move o número para o máximo; clicar na tecla SETA PARA BAIXO move o número para o mínimo.

Devido à funcionalidade versátil, esse controle é uma opção óbvia, por exemplo, se você quiser criar um controle de volume para um aplicativo de player de música. O NumericUpDown controle é usado em muitos aplicativos do Painel de Controle do Windows.

Principais propriedades e métodos

Os números exibidos na caixa de texto do controle podem estar em uma variedade de formatos, incluindo hexadecimal. Para obter mais informações, consulte Como definir o formato do controle NumericUpDown dos Windows Forms. As propriedades principais do controle são Value, Maximum (valor padrão 100), Minimum (valor padrão 0) e Increment (valor padrão 1). A Value propriedade define o número atual selecionado no controle. A Increment propriedade define o valor pelo qual o número é ajustado quando o usuário clica em uma seta para cima ou para baixo. Quando o foco sair do controle, qualquer entrada tipada será validada em relação aos valores numéricos mínimos e máximos. Você pode aumentar a velocidade que o controle move através dos números, quando o usuário pressiona continuamente a seta para cima ou para baixo, com a Accelerations propriedade. Os principais métodos do controle são UpButton e DownButton.

Consulte também

• NumericUpDown
• Controle NumericUpDown
• Como definir o formato do controle NumericUpDown dos Windows Forms
• Controle TextBox