Avec l’instruction :
scale chemin ´Echelle?options?
la commande scale cr´ee une nouvelle commande Tcl dont le nom est pr´ecis´ement chemin ´Echelle. Cette commande peut ˆetre compl´et´ee par des sous-commandes per- mettant d’effectuer diverses op´erations concernant l’´echelle. La forme g´en´erale est :
Les op´erations reconnues par les composantes de type scale sont les suivantes : chemin ´Echelle cget option
Renvoie la valeur courante de l’option de configuration sp´ecifi´ee par l’argu- ment option. L’argument option peut ˆetre une quelconque des valeurs ac- cept´ees par la commande scale.
chemin ´Echelle configure?option??valeur option valeur ...?
Permet d’obtenir ou de modifier les options de configuration de l’´echelle gradu´ee. Si l’argument option n’est pas sp´ecifi´e, la commande renvoie une liste de toutes les options disponibles pour chemin ´Echelle.
Si l’argument option est sp´ecifi´e sans une valeur correspondante, la commande renvoie une liste d´ecrivant l’option nomm´ee. Si un ou plusieurs couples option- valeur sont sp´ecifi´es, les options en question se voient attribuer la valeur cor- respondante : la commande renvoie alors une chaˆıne vide. L’argument option peut ˆetre une quelconque des valeurs accept´ees par la commande scale. chemin ´Echelle coords?valeur?
Renvoie une liste de deux ´el´ements qui sont les coordonn´ees x et y du point situ´e sur la ligne m´ediane de la glissi`ere et correspond `a la valeur sp´ecifi´ee par l’argument valeur. Si valeur est omis, la valeur courante de l’´echelle est utilis´ee.
chemin ´Echelle get?x y?
Si x et y sont omis, cette commande renvoie la valeur courante de l’´echelle. Si x et y sont sp´ecifi´es, ils indiquent les coordonn´ees en pixels d’un point dans l’´echelle ; la commande renvoie alors la valeur de l’´echelle correspondant `a ce point. Seule une des coordonn´ees x et y est utilis´ee : x pour les ´echelles horizontales et y pour les ´echelles verticales.
chemin ´Echelle identify x y
Renvoie une chaˆıne qui indique quelle partie de l’´echelle se trouve sous le point de coordonn´ees x et y. Une valeur de retour peut prendre une des valeurs symboliques suivantes :
– slider d´esigne le curseur ;
– trough1 d´esigne la partie de la glissi`ere qui se trouve avant le curseur ; – trough2 d´esigne la partie de la glissi`ere qui se trouve apr`es le curseur ; Si le point de coordonn´ees x et y n’est pas au-dessus d’un de ces ´el´ements, la commande renvoie une chaˆıne vide.
chemin ´Echelle set valeur
Cette commande est invoqu´ee pour modifier la valeur courante de l’´echelle, et par cons´equent la position o`u le curseur est affich´e. L’argument valeur donne la nouvelle valeur de l’´echelle. Cette commande est sans effet si l’´echelle est d´esactiv´ee.
-activebackground activeBackground Foreground -background ou -bg background Background -borderwidth ou -bd borderWidth BorderWidth
-cursor cursor Cursor
-font font Font
-foreground ou -fg foreground Foreground
-highlightbackground highlightBackground HighlightBackground -highlightcolor highlightColor HighlightColor -highlightthickness highlightThickness HighlightThickness
-relief relief Relief
-repeatdelay repeatDelay RepeatDelay
-repeatinterval repeatInterval RepeatInterval
-takefocus takeFocus TakeFocus
-troughcolor troughColor Background
Tab. 13 – Options standard reconnues par les composants de type scale.
Liaisons par d´efaut
Tk cr´ee automatiquement des liaisons de classe pour les ´echelles gradu´ees avec les caract´eristiques suivantes (le comportement peut diff´erer pour les ´echelles hori- zontales et verticales) :
1. Si le premier bouton de la souris est enfonc´e dans la glissi`ere, la valeur de l’´echelle sera incr´ement´ee ou d´ecr´ement´ee de la valeur de l’option -resolution de telle sorte que le curseur se d´eplace dans la direction du pointeur. Si le bouton est maintenu, l’action se r´ep`ete.
2. Si le premier bouton de la souris est enfonc´e au-dessus du curseur, le curseur peut ˆetre d´eplac´e en glissant la souris.
3. Si le premier bouton de la souris est press´e dans la glissi`ere avec la touche Contrˆole enfonc´ee, le curseur se d´eplace jusqu’`a l’extrˆemit´e de l’intervalle dans la direction du pointeur.
4. Si le second bouton de la souris est enfonc´e, la valeur de l’´echelle est fix´ee `a la position de la souris. Si la souris est gliss´ee avec le second bouton enfonc´e, la valeur de l’´echelle change en suivant le d´eplacement.
5. Les touches Haut et Gauche d´eplacent le curseur vers le haut (resp. la gauche) de la valeur de l’option -resolution.
6. Les touches Bas et Droite d´eplacent le curseur vers le bas (resp. la droite) de la valeur de l’option -resolution.
7. Les combinaisons de touches Contrˆole-Haut et Contrˆole-Gauche d´eplacent le curseur vers le haut (resp. la gauche) de la valeur de l’option -bigIncrement. 8. Les combinaisons de touches Contrˆole-Bas et Contrˆole-Droite d´eplacent le curseur vers le bas (resp. la droite) de la valeur de l’option -bigIncrement. 9. La touche D´ebut (Home) d´eplace le curseur `a l’extrˆemit´e sup´erieure (ou
10. La touche Fin (End ) d´eplace le curseur `a l’extrˆemit´e inf´erieure (ou droite) de l’intervalle.
Si l’´echelle est d´esactiv´ee au moyen de l’option -state, toutes les liaisons ci- dessus sont sans effet.
Les comportements d´ecrits sont les comportements par d´efaut et peuvent tou- jours ˆetre modifi´es en d´efinissant de nouvelles liaisons pour des ´echelles particuli`eres ou en red´efinissant les liaisons de classe.
Options standard
Les options standard support´ees par les composants de type scale sont ras- sembl´ees dans le tableau 13 de la page pr´ec´edente. Ces options sont d´ecrites en d´etail `a la page 142.
Options sp´ecifiques
-bigincrement bigIncrement BigIncrement
Certaines interactions avec l’´echelle gradu´ee font que sa valeur change par de (( grandes )) diff´erences ; cette option sp´ecifie ce que l’on consid`ere comme une grande diff´erence. Si la valeur sp´ecifi´ee est 0, les incr´ements en question vaudront par d´efaut 1/10 de l’´etendue compl`ete de l’´echelle gradu´ee.
-command command Command
Sp´ecifie le pr´efixe d’une commande Tcl `a invoquer chaque fois que la valeur de l’´echelle gradu´ee est modifi´ee par une commande. La commande v´eritable qui sera ex´ecut´ee est constitu´ee de la valeur de cette option suivie par une espace puis un nombre r´eel indiquant la nouvelle valeur de l’´echelle gradu´ee.
-digits digits Digits
Il s’agit d’un nombre entier qui sp´ecifie combien de chiffres significatifs doivent ˆetre retenus en convertissant la valeur de l’´echelle gradu´ee en une chaˆıne. Si le nombre est n´egatif ou nul l’´echelle gradu´ee choisit la plus petite valeur garantis- sant que chaque position possible de l’´echelle puisse ˆetre marqu´ee par une chaˆıne diff´erente.
-from from From
Une valeur r´eelle correspondant, selon son orientation, `a l’extrˆemit´e gauche ou sup´erieure de l’´echelle gradu´ee.
-label label Label
Une chaˆıne `a afficher comme ´etiquette pour l’´echelle gradu´ee. Pour les ´echelles verticales l’´etiquette est affich´ee imm´ediatement `a droite de l’extrˆemit´e sup´erieure
de l’´echelle gradu´ee. Pour les ´echelles horizontales l’´etiquette est affich´ee imm´ediate- ment au-dessus de l’extrˆemit´e gauche de l’´echelle gradu´ee. Si l’option est sp´ecifi´ee comme une chaˆıne vide, aucune ´etiquette n’est affich´ee.
-length length Length
Sp´ecifie la valeur souhait´ee pour la dimension longue de l’´echelle gradu´ee, en unit´es d’´ecran. Pour les ´echelles verticales c’est la hauteur de l’´echelle gradu´ee ; pour les ´echelles horizontales, c’est sa largeur.
-orient orient Orient
Cette option sp´ecifie l’orientation (horizontale ou verticale) `a utiliser. Elle doit prendre une des valeurs symboliques suivantes : horizontal ou vertical ou une abr´evia- tion de ces termes.
-resolution resolution Resolution
Une valeur r´eelle sp´ecifiant la (( r´esolution )) de l’´echelle gradu´ee : si cette valeur est positive, la valeur de l’´echelle gradu´ee sera toujours arrondie `a un multiple entier de cette valeur, tout comme les graduations et les extrˆemit´es de l’´echelle.
-showvalue showValue ShowValue
Sp´ecifie une valeur bool´eenne indiquant si la valeur courante de l’´echelle gradu´ee doit ˆetre affich´ee ou non.
-sliderlength sliderLength SliderLength
Sp´ecifie la taille du curseur mesur´ee en unit´es d’´ecran le long de la dimension longue du curseur. La valeur est exprim´ee en unit´es d’´ecran.
-sliderrelief sliderRelief SliderRelief
Sp´ecifie le relief `a utiliser pour dessiner le curseur, comme par exemple raised ou sunken.
-state state State
Sp´ecifie l’un des trois ´etats normal, active ou disabled pour l’´echelle gradu´ee. Si l’´echelle gradu´ee est d´esactiv´ee, la valeur ne peut ˆetre modifi´ee et l’´echelle gradu´ee ne r´eagira pas. Si l’´echelle gradu´ee est active, le curseur est affich´e en utilisant la couleur sp´ecifi´ee par l’option activeBackground.
-tickinterval tickInterval TickInterval
Cette option doit prendre une valeur r´eelle qui d´etermine l’espace entre les marques de graduation num´eriques affich´ees en dessous ou `a gauche du curseur. Si la valeur est 0, aucune marque de graduation n’est affich´ee.
-to to To Sp´ecifie une valeur r´eelle correspondant `a l’extrˆemit´e droite ou inf´erieure de l’´echelle gradu´ee. Cette valeur doit ˆetre au moins ´egale `a celle sp´ecifi´ee par l’option from.
-troughcolor troughColor Background
Sp´ecifie la couleur `a utiliser pour la glissi`ere.
-variable variable Variable
Sp´ecifie le nom d’une variable globale `a lier `a l’´echelle gradu´ee. Chaque fois que la valeur de la variable change, l’´echelle gradu´ee est mise `a jour pour refl´eter la nouvelle valeur. Chaque fois que l’´echelle gradu´ee est manipul´ee interactivement, la variable est modifi´ee elle aussi pour refl´eter la nouvelle valeur de l’´echelle gradu´ee.
-width width Width
scrollbar
Permet de cr´eer et de manipuler les barres de d´efilement.
Syntaxe
scrollbar cheminBarre?options?
Description
La commande scrollbar cr´ee une nouvelle fenˆetre (indiqu´ee par l’argument che- minBarre) et en fait un composant graphique de type barre de d´efilement. On peut sp´ecifier des options suppl´ementaires soit par une ligne de commandes, soit direc- tement dans la base de ressources pour configurer certaines caract´eristiques de la barre de d´efilement telles que la couleur, la police ou le relief etc. La commande scrollbar renvoie la valeur de son argument cheminBarre. Au moment de son in- vocation, il ne doit exister aucune autre fenˆetre nomm´ee cheminBarre, mais en revanche l’objet parent de cheminBarre doit d´ej`a exister.
Une barre de d´efilement est un composant graphique qui affiche des fl`eches aux deux extrˆemit´es d’une glissi`ere et un curseur dans sa partie interm´ediaire. Elle renseigne sur la partie visible de la fenˆetre de document qui lui est associ´ee selon la position et la taille du curseur. Inversement, on peut ajuster la vue d’un document en d´epla¸cant le curseur.
´
El´ements
Une barre de d´efilement affiche cinq ´el´ements auxquels les commandes associ´ees se r´ef`erent de la mani`ere suivante :
arrow1
La fl`eche sup´erieure ou gauche de la barre de d´efilement. trough1
La r´egion entre le curseur et l’´el´ement arrow1. slider
Le rectangle dit (( curseur )) qui indique la proportion de ce qui est visible dans la fenˆetre associ´ee.
trough2
La r´egion entre le curseur et l’´el´ement arrow2. arrow2
La fl`eche inf´erieure ou droite de la barre de d´efilement.