DESCRIPTION.

La procédure PROC_trackbar() crée une échelle de valeurs, et le place dans sa boite de dialogue.

SYNTAXE.

PROC_trackbar( boite , "" , identifiant , abscisse , ordonnee , largeur , hauteur , style )

REMARQUES.

boite doit être l'identifiant de la boite de dialogue qui accueillera l'échelle de valeur. Il s'agit du nom de la variable qui a reçu la valeur retournée par la fonction FN_newdialog() pour la création de boite.

Le deuxième paramètre est obligatoire et doit toujours être une chaine vide "", bien qu'une autre string ne semble pas retourner d'erreur.

identifiant doit être un nombre entier supérieur à 11.  Tous les controles d'une même boîte de dialogue doivent avoir un identifiant unique mais un identifiant peut être utilisé par plusieurs controles dans des boites de controle différentes.identifiant peut être la valeur retournée par la fonction FN_setproc(); en particulier si le programme doit utiliser identifiant pour connaitre le contenu du champs de saisie. Voir la procédure  PROC_button() pour les valeurs spéciales réservées aux boutons cliquables.

abscisse doit être des nombre entier, exprimé en unités de boite de dialogue, indiquant l'abscisse du bord gauche l'échelle de valeurs dans boite, c'est-à-dire par rapport au bord gauche de boite.

ordonnee doit être des nombre entier, exprimé en unités de boite de dialogue, indiquant l'ordonnée du bord haut l'échelle de valeurs dans boite, c'est-à-dire par rapport au bord haut de boite.

largeur doit être un nombre entier, exprimé en unités de boite de dialogue, donnant la largeur disponible pour la représentation de l'échelle de valeurs.

hauteur doit être un nombre entier, exprimé en unités de boite de dialogue, donnant la hauteur disponible pour la représentation de l'échelle de valeurs.

style précise le style visuel du champ de saisie. style peut valoir : 

- 0, valeur par défaut, pour afficher de l'échelle de valeurs standard ;

- 134217728 (&8000000), pour afficher de l'échelle de valeurs grisé, désactivé ;

- 268435456 (&10000000), pour cacher l'échelle de valeurs.

La procédure PROC_trackbar() ne gérant pas les cliques de souris, il faudra utilisée la procédure PROC_registerdlgcallback() qui permet de définir une fonction qui sera appelée à intervales régulier, ou si une touche est pressée, pour connaitre les modification de valeurs d'échelle de valeurs.

Voir la fonction FN_newdialog() qui permet de déclarer et de créer une boite de dialogue. 

Voir la procédure PROC_settrackbarpos() qui permet de définir les bornes de l'échelle de valeurs.

Voir la procédure FN_gettrackbarpos() qui retourne la valeur actuelle de l'échelle.

La procédure PROC_trackbar() est importée depuis le module dlglib.bbc. 

EXEMPLE.

REM --- Importation des modules ---

REM --- Module de la bibliothèque BBC BASIC ---

INSTALL @lib$ + "dlglib.bbc"

REM --- Chargement de la police de caracteres par defaut ---

OSCLI "FONT """ + @lib$ + "DejaVuSans"",12" 

REM --- Creation d'une boite de dialogue nommee DLG_Test de 160 x 60 unites intitulee Test ---

DLG_Test = FN_newdialog( "Test ..." , 120 , 60 )

PROC_registerdlgcallback( DLG_Test, FN_Event() ) 

REM --- Creation des controles de la boite de dialogue ---

PROC_button( DLG_Test , "Fermer." , 8 , 40 , 35 , 40 , 15 , 0 )

PROC_trackbar( DLG_Test , "" , 101 , 10 , 10 , 100 , 15 , 0 ) 

PROC_settrackbarpos( DLG_Test , 101 , 0 , -20 , 50 )

REM --- Affichage de la boite de dialogue et attende des choix de l'utilisateur ---

kcontrole = FN_showdialog( DLG_Test , &FFFFFFFF80000000 , &FFFFFFFF80000000 )  

REM --- Fermeture de la boite de dialogue ---

PROC_closedialog( DLG_Test ) 

REM --- Fin du programme ---

PRINT : PRINT "Au revoir."

END

REM --- DEFINITION DES METHODES PERSONNALISEES ---

REM --- Procedures de surveillance de la la boite de dialogue DLG_Test ---

DEF FN_Event( Qboite , Qaction ) : PRINT TAB( 0 , 0 ) FN_gettrackbarpos( DLG_Test , 101 ) : = 0