Partilhar 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 de valor numérico fixo. 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 parte da caixa de texto do controle. Clicar na tecla SETA PARA CIMA move o número em direção ao máximo; clicar na tecla SETA PARA BAIXO move o número para o mínimo.

Devido à sua funcionalidade versátil, este controlo é uma escolha óbvia, por exemplo, se pretender criar um controlo de volume para uma aplicação de leitor 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 para o controle NumericUpDown do Windows Forms. As principais propriedades 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 se move 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 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 propriedade Accelerations. Os principais métodos do controle são UpButton e DownButton.

Ver também