Partilhar via


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. O usuário pode aumentar e diminuir o número clicando nas setas para cima e para baixo, pressionando as teclas de direção para cima ou para baixo ou digitando um número na parte de caixa de texto do controle. Clicar na seta para cima move o número em direção ao máximo; clicar na seta para baixo move o número em direção ao mínimo.

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

Propriedades e métodos de tecla

Os números exibidos na caixa de texto do controle podem estar em uma variedade de formatos, incluindo hexadecimais. Para obter mais informações, consulte Como definir o formato para o controle NumericUpDown dos Windows Forms. As propriedades de chave 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 é movido para fora do controle, qualquer entrada digitada será validada em relação aos valores numéricos mínimo e máximo. Você pode aumentar a velocidade com que o controle se move através de 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.

Confira também