Compartilhar via

Visão geral do controle NumericUpDown (Windows Forms)

  • Artigo

O controle NumericUpDown 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 de seta para cima e 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 controle NumericUpDown é 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 nos 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 propriedade Value define o número atual selecionado no controle. A propriedade Increment define a quantidade pela 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 de números, quando o usuário pressiona continuamente a seta para cima ou para baixo, com a propriedade Accelerations. Os principais métodos do controle são UpButton e DownButton.

Consulte também