Partager via


Utilisation de CSpinButtonCtrl

Le contrôle de bouton de rotation (également appelé contrôle haut vers le bas ) fournit une paire de flèches qu’un utilisateur peut cliquer pour ajuster une valeur. Cette valeur est appelée position actuelle. La position reste dans la plage du bouton de rotation. Lorsque l’utilisateur clique sur la flèche vers le haut, la position se déplace vers le maximum ; et lorsque l’utilisateur clique sur la flèche vers le bas, la position se déplace vers le minimum.

Le contrôle spin button est représenté dans MFC par la classe CSpinButtonCtrl .

Remarque

Par défaut, la plage du bouton de rotation a la valeur maximale définie sur zéro (0) et la valeur minimale définie sur 100. Étant donné que la valeur maximale est inférieure à la valeur minimale, le fait de cliquer sur la flèche vers le haut diminue la position et de cliquer sur la flèche vers le bas l’augmente. Utilisez CSpinButtonCtrl ::SetRange pour ajuster ces valeurs.

En règle générale, la position actuelle est affichée dans un contrôle complémentaire. Le contrôle compagnon est connu sous le nom de fenêtre associée. Pour obtenir une illustration d’un contrôle de bouton de rotation, consultez About Up-Down Controls in the Windows SDK.

Pour créer un contrôle Spin et une fenêtre associée du contrôle Edit, dans Visual Studio, faites glisser au préalable un contrôle Edit vers la boîte de dialogue ou la fenêtre, puis faites glisser à son tour un contrôle Spin. Sélectionnez le contrôle spin et définissez ses propriétés Auto Buddy et Set Buddy Integer sur True. Définissez également la propriété Alignment ; L’alignement droit est le plus courant. Avec ces paramètres, le contrôle Edit est défini comme fenêtre associée car elle précède directement le contrôle Edit dans l'ordre de tabulation. Le contrôle d’édition affiche des entiers et le contrôle spin est incorporé dans le côté droit du contrôle d’édition. Si vous le souhaitez, vous pouvez définir la plage valide du contrôle spin à l’aide de la méthode CSpinButtonCtrl ::SetRange . Aucun gestionnaire d’événements n’est nécessaire pour communiquer entre le contrôle de rotation et la fenêtre associée, car ils échangent directement des données. Si vous utilisez un contrôle spin à d’autres fins, par exemple pour parcourir une séquence de fenêtres ou de boîtes de dialogue, ajoutez un gestionnaire pour le message UDN_DELTAPOS et effectuez votre action personnalisée.

Que voulez-vous en savoir plus sur

Voir aussi

Contrôles