Fonctions membres de contrôle Slider
Une application peut appeler les fonctions membres du contrôle curseur pour récupérer des informations sur le contrôle slider (CSliderCtrl) et modifier ses caractéristiques.
Pour récupérer la position du curseur (autrement dit, la valeur choisie par l’utilisateur), utilisez la fonction membre GetPos . Pour définir la position du curseur, utilisez la fonction membre SetPos . À tout moment, vous pouvez utiliser la VerifyPos fonction membre pour vous assurer que le curseur est compris entre les valeurs minimales et maximales.
La plage d’un contrôle de curseur est l’ensemble de valeurs contiguës que le contrôle curseur peut représenter. La plupart des applications utilisent la fonction membre SetRange pour définir la plage d’un contrôle de curseur lors de sa création. Les applications peuvent modifier dynamiquement la plage une fois le contrôle de curseur créé à l’aide des fonctions membres SetRangeMax et SetRangeMin . Une application qui permet à la plage d’être modifiée dynamiquement récupère généralement les paramètres de plage finaux lorsque l’utilisateur a fini d’utiliser le contrôle curseur. Pour récupérer ces paramètres, utilisez les fonctions membres GetRange, GetRangeMax et GetRangeMin .
Une application peut utiliser le style ToS_AUTOTICKS pour afficher automatiquement les graduations d’un contrôle de curseur. Si une application doit contrôler la position ou la fréquence des graduations, toutefois, un certain nombre de fonctions membres peuvent être utilisées.
Pour définir la position d’une graduation, une application peut utiliser la fonction membre SetTic . La fonction membre SetTicFreq permet à une application de définir des graduations qui apparaissent à intervalles réguliers dans la plage du contrôle de curseur. Par exemple, l’application peut utiliser cette fonction membre pour afficher seulement 10 graduations dans une plage de 1 à 100.
Pour récupérer l’index dans la plage correspondant à une graduation, utilisez la fonction membre GetTic . La fonction membre GetTicArray récupère un tableau de ces index. Pour récupérer la position d’une graduation, dans les coordonnées du client, utilisez la fonction membre GetTicPos . Une application peut récupérer le nombre de graduations à l’aide de la fonction membre GetNumTics .
La fonction membre ClearTics supprime toutes les graduations d’un contrôle de curseur.
La taille de ligne d’un contrôle de curseur détermine la distance à laquelle le curseur se déplace lorsqu’une application reçoit un message de notification To_LINEDOWN ou To_LINEUP. De même, la taille de la page détermine la réponse aux messages de notification To_PAGEDOWN et To_PAGEUP. Les applications peuvent récupérer et définir les valeurs de taille de ligne et de page à l’aide des fonctions membres GetLineSize, SetLineSize, GetPageSize et SetPageSize .
Une application peut utiliser des fonctions membres pour récupérer les dimensions d’un contrôle de curseur. La fonction membre GetThumbRect récupère le rectangle englobant du curseur. La fonction membre GetChannelRect récupère le rectangle englobant du canal du contrôle de curseur. (Le canal est la zone sur laquelle le curseur se déplace et qui contient la mise en surbrillance lorsqu’une plage est sélectionnée.)
Si un contrôle de curseur a le style ToS_ENABLESELRANGE, l’utilisateur peut sélectionner une plage de valeurs contiguës à partir de celle-ci. Un certain nombre de fonctions membres permettent l’ajustement dynamique de la plage de sélection. La fonction membre 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 GetSelection . Pour effacer la sélection d’un utilisateur, utilisez la fonction membre ClearSel .