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 Spin. 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 Spin 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, cliquez sur la flèche vers le haut pour diminuer la position et cliquez sur la flèche vers le bas pour l'augmenter. Utilisez CSpinButtonCtrl ::SetRange pour ajuster ces valeurs.

En général, la position actuelle est affichée dans un contrôle compagnon. Le contrôle compagnon est connu sous le nom de fenêtre de pote. Pour obtenir une illustration d’un contrôle de bouton spin, consultez À propos des contrôles haut vers le bas dans le Kit de développement logiciel (SDK) Windows.

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 Edit affiche des entiers et le contrôle Spin est incorporé dans la partie droite du contrôle Edit. 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 requis pour la communication entre le contrôle Spin et la fenêtre associée car ils échangent des données directement. Si vous utilisez un contrôle spin à d’autres fins, par exemple pour pager 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