Partilhar via


Usando CSpinButtonCtrl

O controle de botão giratório (também conhecido como controle de cima para baixo ) fornece um par de setas em que um usuário pode clicar para ajustar um valor. Este 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 giratório é representado no MFC pela classe CSpinButtonCtrl .

Observação

Por padrão, o intervalo para o botão giratório 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 a aumenta. Use CSpinButtonCtrl::SetRange para ajustar esses valores.

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

Para criar um controle de rotação e uma janela de parceiro do controle 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 Auto Buddy e set Buddy Integer como True. Defina também a propriedade Alignment ; O alinhamento à direita é o mais típico. Com estas configurações, o controlo de edição é definido como a janela associada porque precede diretamente o controlo de edição na ordem de tabulação. O controle de edição exibe inteiros e o controle de rotação é incorporado 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 se comunicar entre o controlo de rotação e a janela associada, porque 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

Ver também

Controlos