Compartilhar via


Usando CSpinButtonCtrl

O controle de botão giratório (também conhecido como controle de incremento e decremento) fornece um par de setas que um usuário pode clicar para ajustar um valor. Esse valor é conhecido como a posição atual. A posição permanece dentro do alcance do botão giratório. Quando o usuário clica na seta para cima, a posição se move em direção ao máximo; e quando o usuário clica na seta para baixo, a posição se move em direção ao mínimo.

O controle de botão de rotação é representado no MFC pela classe CSpinButtonCtrl .

Observação

Por padrão, o intervalo do botão de rotação tem o máximo definido como zero (0) e o mínimo definido como 100. Como o valor máximo é menor que o valor mínimo, clicar na seta para cima diminui a posição e clicar na seta para baixo aumenta. Use CSpinButtonCtrl::SetRange para ajustar esses valores.

Normalmente, a posição atual é exibida em um controle complementar. O controle complementar é conhecido como a janela do amigo. Para obter uma ilustração de um controle de botão de rotação, consulte Sobre Up-Down Controles no SDK do Windows.

Para criar um controle de rotação e um controle associado de edição no Visual Studio, primeiro arraste um controle de edição para a caixa de diálogo ou janela e, em seguida, arraste um controle de rotação. Selecione o controle de rotação e defina suas propriedades de Auto Buddy e Set Buddy Integer como True. Defina também a propriedade Alignment ; O Alinhamento à Direita é mais típico. Com essas configurações, o controle de edição é definido como a janela buddy porque ela precede diretamente o controle de edição na ordem de tabulação. O controle de edição exibe inteiros e o controle de rotação é inserido no lado direito do controle de edição. Opcionalmente, você pode definir o intervalo válido do controle de rotação usando o método CSpinButtonCtrl::SetRange . Nenhum manipulador de eventos é necessário para a comunicação entre o controle rotativo e a janela associada, pois eles trocam dados diretamente. Se você usar um controle de rotação para alguma outra finalidade, por exemplo, para percorrer uma sequência de janelas ou caixas de diálogo, adicione um manipulador para a mensagem UDN_DELTAPOS e execute sua ação personalizada lá.

O que você quer saber mais sobre

Consulte também

Controles