Fonctions membres de contrôle Slider
Une application peut appeler les fonctions membres du contrôle Slider pour récupérer des informations sur le contrôle Slider (CSliderCtrl) et de modifier ses caractéristiques.
Pour récupérer la position du curseur (autrement dit, la valeur que l'utilisateur a sélectionné), utilisez la fonction membre de GetPos .Pour définir la position du curseur, utilisez la fonction membre de SetPos .À tout moment vous pouvez utiliser la fonction membre d' VerifyPos pour vous assurer que le curseur se trouve entre les valeurs minimales et maximales.
La plage d'un contrôle Slider est l'ensemble de valeurs contiguës que le contrôle Slider peut représenter.La plupart des applications utilisent la fonction membre de SetRange pour définir la plage d'un contrôle Slider lors de le premier créée.Les applications peuvent modifier dynamiquement la plage après le contrôle Slider a été créées à l'aide de les fonctions membres de SetRangeMax et de SetRangeMin .Une application qui permet la plage à changer dynamiquement classique récupère les paramètres ultimes de plage lorsque l'utilisateur a terminé d'utiliser le contrôle Slider.Pour récupérer ces paramètres, utilisez les fonctions membres de GetRange, de GetRangeMax, et de GetRangeMin .
Une application peut utiliser le style d' TBS_AUTOTICKS d'avoir des graduations d'un contrôle Slider affichées automatiquement.Si une application doit contrôler la position ou fréquence des graduations, toutefois, plusieurs fonctions membres peuvent être utilisées.
Pour définir la position d'une graduation, une application peut utiliser la fonction membre de SetTic .La fonction membre de SetTicFreq permet à une application de définir les graduations qui s'affichent à intervalles réguliers dans la plage du contrôle Slider.Par exemple, l'application peut utiliser cette fonction membre pour afficher uniquement 10 graduations dans une plage de 1 à 100.
Pour extraire l'index dans la plage correspondant à une graduation, utilisez la fonction membre de GetTic .La fonction membre de GetTicArray récupère un tableau de ces index.Pour récupérer la position d'une graduation, dans les coordonnées clientes, utilisez la fonction membre de GetTicPos .Une application peut récupérer le nombre de graduations à l'aide de la fonction membre de GetNumTics .
La fonction membre de ClearTics supprime toutes les graduations d'un contrôle Slider.
Une taille de la ligne de contrôle Slider détermine la distance les déplacements de curseur lorsqu'une application message reçoit de TB_LINEDOWN ou de TB_LINEUP notification.De même, la Taille de page détermine la réponse des messages de TB_PAGEDOWN et de TB_PAGEUP à notification.Les applications peuvent récupérer et définir les valeurs de ligne et de Taille de page à l'aide de les fonctions membres de GetLineSize, de SetLineSize, de GetPageSize, et de SetPageSize .
Une application peut utiliser les fonctions membres pour récupérer les dimensions d'un contrôle Slider.La fonction membre de GetThumbRect extrait le rectangle englobant du curseur.La fonction membre de GetChannelRect extrait le rectangle englobant du canal du contrôle Slider.(Le canal est la zone sur le choix du curseur se déplace et de laquelle contient la mise en surbrillance lorsqu'une plage est sélectionnée.)
Si un contrôle Slider utilise un style d' TBS_ENABLESELRANGE , l'utilisateur peut sélectionner une plage de valeurs contiguës de celui-ci.Plusieurs fonctions membres permettent la plage de sélection à personnaliser dynamiquement.La fonction membre de SetSelection définit les positions de début et de fin d'une sélection.Lorsque l'utilisateur a terminé de définir une plage de sélection, une application peut récupérer les paramètres à l'aide de la fonction membre de GetSelection .Pour effacer la sélection d'un utilisateur, utilisez la fonction membre de ClearSel .