- NOM
- scale - Crée et manipule les widgets scale
- SYNTAXE
- scale pathName ?options?
- OPTIONS STANDARD
- -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
- -orient, orient, Orient
- -relief, relief, Relief
- -repeatdelay, repeatDelay, RepeatDelay
- -repeatinterval, repeatInterval, RepeatInterval
- -takefocus, takeFocus, TakeFocus
- -troughcolor, troughColor, Background
- OPTIONS SPECIFIQUES AU WIDGET
- -bigincrement, bigIncrement, BigIncrement
- -command, command, Command
- -digits, digits, Digits
- -from, from, From
- -label, label, Label
- -length, length, Length
- -résolution, résolution, Resolution
- -showvalue, showValue, ShowValue
- -sliderlength, sliderLength, SliderLength
- -sliderrelief, sliderRelief, SliderRelief
- -state, state, State
- -tickinterval, tickInterval, TickInterval
- -to, to, To
- -variable, variable, Variable
- -width, width, Width
- DESCRIPTION
- COMMANDES DE WIDGET
- pathName cget option
- pathName configure ?option? ?valeur option valeur ...?
- pathName coords ?valeur?
- pathName get ?x y?
- pathName identify x y
- pathName set valeur
- BINDINGS
- MOTS-CLES
scale - Crée et manipule les widgets scale
scale pathName ?options?
- -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
- -orient, orient, Orient
- -relief, relief, Relief
- -repeatdelay, repeatDelay, RepeatDelay
- -repeatinterval, repeatInterval, RepeatInterval
- -takefocus, takeFocus, TakeFocus
- -troughcolor, troughColor, Background
- Command-Line Name: -bigincrement
- Database Name: bigIncrement
- Database Class: BigIncrement
- Certaines interactions avec le scale modifient sa valeur de
``grands'' incréments; cette option indique la taille des
grands incréments. Si 0 est spécifié, les grands incréments sont par défaut de 1/10 de l'étendue du scale.
- Command-Line Name: -command
- Database Name: commande
- Database Class: Command
- Indique le prefixe d'une commande Tcl à appeler chaque fois que la valeur du scale est modifiée par une commande widget.
La commande consiste
en cette option suivi par un espace et un nombre réel indiquant la
nouvelle valeur du scale.
- Command-Line Name: -digits
- Database Name: digits
- Database Class: Digits
- Un entier indiquant cobien de chiffres significatifs doivent être pris en compte
pendant la conversion de la valeur du scale en une chaîne.
Si le nombre est inférieur ou égal à zéro, alors le scale prend
la plus petite valeur qui garantit que chaque position possible de l'ascenseur affiche une chaîne différente.
- Command-Line Name: -from
- Database Name: from
- Database Class: From
- Valeur réelle correspondant à l'extrémité gauche ou supérieure du scale.
- Command-Line Name: -label
- Database Name: label
- Database Class: Label
- Chaîne à afficher comme libéllé du scale. Pour les
scales verticaux le libéllé est affiché juste à droite de l'extrémité
supérieure du scale. Pour les scales horizontales le libéllé est affiché
juste au dessus de l'extrémité du scale. Si l'option est spécifiée
comme une chaîne vide, aucun libéllé n'est affiché.
- Command-Line Name: -length
- Database Name: length
- Database Class: Length
- Indique la longueur désirée du scale en unités d'écran
(c.a.d. n'importe quelle des formes acceptables par Tk_GetPixels).
Pour les scales verticaux c'est la hauteur du scale; pour les scales horizontaux
c'est la largeur du scale.
- Command-Line Name: -resolution
- Database Name: résolution
- Database Class: Resolution
- Valeur réelle indiquant la résolution du scale.
Si cette valeur est supérieure à zéro alors la valeur du scale sera toujours arrondie à un multiple pair de cette valeur, comme seront enregistrées les marks et
les extrémités du scale. Si la valeur est inférieure à zéro alors aucun
arrondi ne se produit. Par défaut de 1 (c.a.d., la valeur sera intégrale).
- Command-Line Name: -showvalue
- Database Name: showValue
- Database Class: ShowValue
- Indique une valeur booléenne indiquant si oui ou non la valeur courante
du scale doit être affichée.
- Command-Line Name: -sliderlength
- Database Name: sliderLength
- Database Class: SliderLength
- Indique la taille de l'ascenseur, mesurée en unités d'écran dans la logueur de l'ascenseur. La valeur peut être spécifié sous n'importe quelle des formes acceptable
par Tk_GetPixels.
- Command-Line Name: -sliderrelief
- Database Name: sliderRelief
- Database Class: SliderRelief
- Indique le relief à utiliser pour l'affichage de l'ascenseur, comme raised
ou sunken.
- Command-Line Name: -state
- Database Name: state
- Database Class: State
- Indique un des trois états du scale: normal,
active, ou disabled.
Si le scale est désactivé alors la valeur ne sera pas modifiée et le scale
ne s'activera pas.
Si le scale est actif, l'ascenseur est affiché en utilisant la couleur
spécifiée par l'option activeBackground.
- Command-Line Name: -tickinterval
- Database Name: tickInterval
- Database Class: TickInterval
- Doit être a real valeur.
Determines l'espace entre les marques numériques affichées en dessous ou à gauche de l'ascenseur.
Si 0, aucune marque ne sera affichée.
- Command-Line Name: -to
- Database Name: to
- Database Class: To
- Indique la valeur réelle correspondant
à l'extrémité droite ou inférieure du scale.
Cette valeur peut être soit inférieure à ou supérieur à l'option from.
- Command-Line Name: -variable
- Database Name: variable
- Database Class: Variable
- Indique le nom de la variable globale à relier au scale. Chaque fois que la
valeur de la variable change, le scale est mis à jour pour refléter cette
valeur.
Chaque fois que le scale est manipulé interactivement, la variable
sera modifiée pour refléter la nouvelle valeur du scale.
- Command-Line Name: -width
- Database Name: width
- Database Class: Width
- Indique la dimension étroite désirée du creux en unités d'écran
(c.a.d. n'importe quelle des formes acceptables par Tk_GetPixels).
Pour les scales verticaux c'est la largeur du creux; pour les scales horizontaux
c'est la hauteur du creux.
La commande scale crée une nouvelle fenêtre (désignée par l'argument
pathName ) et en fait un widget scale.
Des
options supplémentaires, décrites ci-dessus, peuvent être spécifiées sur la ligne de commande
ou dans la base de données d'options
pour configurer les aspects du scale comme ses couleurs, orientation,
et relief. La commande scale retourne son
argument pathName. A l'instant ou cette commande est appelée,
il ne doit pas exister de fenêtre nommée pathName, mais
son parent doit exister.
Un scale est un widget qui affiche un creux rectangulaire et un
petit ascenseur. Le creux correspond à une étendue
de valeurs réelles (déterminées par les options from, to, et
résolution),
et la position de l'ascenseur sélectionne une valeur réelle particulière.
La position de l'ascenseur (et par conéquent la valeur du scale) peut être ajustée
avec la souris ou le clavier comme décrit dans la section BINDINGS
ci-dessous. Chaque fois que la valeur du scale est modifiée, une commande Tcl
est appelée (en utilisant l'option command ) pour notifier
d'autres widgets du changement.
De plus, la valeur
du scale peut être liée à une variable Tcl (en utilisant l'option variable), ainsi les changement de l'un sont répercutés dans l'autre.
Trois annotations peuvent être affichées dans un widget scale: un libellé
apparaissant en haut à droite du widget (en haut à gauche pour les scales horizontaux), a nombre affiché juste à gauche de l'ascenseur
(juste au dessus de l'ascenseur pour les scales horizontaux), et une collection
de marques numeriques juste à gauche de la valeur courante
(just au dessous du creux pour les scales horizontaux). Chacune de ces trois
annotations peut être activée ou désactivée en utilisant les
options de configuration.
La commande scale crée une nouvelle commande Tcl dont le
nom est pathName. Cette
commande peut être utilisée pour appeler diverses
opérations sur le widget. Elle a la forme générale suivante:
pathName option ?arg arg ...?
Option et args
déterminent le comportement exact de la commande. Les commandes suivantes
sont possibles pour les widgets scale:
- pathName cget option
-
Retourne la valeur courante de l'option de configuration indiquée
par option.
Option peut prendre n'importe quelle des valeurs acceptées par la commande scale.
- pathName configure ?option? ?valeur option valeur ...?
-
Interroge ou modifie les options de configuration du widget.
Si aucune option n'est spécifiée, retourne une liste décrivant toutes
les options disponibles pour pathName (voir Tk_ConfigureInfo pour
information sur le format de cette liste). Si option est spécifié
sans valeur, alors la commande retourne une liste décrivant l'option
désignée (cette liste sera identique à la correspondante
sous-liste de la valeur retournée si aucune option n'est spécifiée). Si
une ou plusieurs paires option-valeur sont spécifiées, alors la commande
donne aux option(s) les valeur(s) indiquées; dans
ce cas la commande retourne une chaîne vide.
Option peut prendre n'importe quelle des valeurs acceptées par la commande scale.
- pathName coords ?valeur?
-
Retourne une liste dont les éléments sont les coordonnées x et y du
point situé sur la ligne centrale du creux qui correspond
à valeur.
Si valeur est omise alors la valeur courant du scale est utilisée.
- pathName get ?x y?
-
Si x et y sont omis, retourne la valeur courante
du scale. Si x et y sont spécifiés, ils indiquent
les coordonnées du pixel à l'intérieur du widget; la commande retourne
la valeur du scale correspondant au pixel indiqué.
Seul l'un de x ou y est utilisé: pour les scales horizontaux
y est ignoré, et pour les scales verticaux x est ignoré.
- pathName identify x y
-
Retourne une chaîne indiquant la partie du scale située à la
coordonnée définie par x et y.
Une valeur de retour de slider signifie que le point est au-dessus
l'ascenseur; trough1 signifie que the point est au-dessus de la
partie de l'ascenseur au dessus ou à gauche de l'ascenseur;
et trough2 signifie que le point est au-dessus de la partie
de l'ascenseur au dessous ou à droite de l'ascenseur.
Si le point n'est pas au-dessus de l'un des deux éléments, une chaîne vide
est retournée.
- pathName set valeur
-
cette commande est appelée pour changer la valeur courante du scale,
et par suite la position à laquelle l'ascenseur est affiché. Value
donne la nouvelle valeur du scale.
La commande n'a pas d'effet si le scale est désactivé.
Tk crée automatiquement des bindings de classe pour les scales qui leur donne le comportement par défaut suivant.
Quand le comportement est différent pour les scales verticaux et horizontaux,
le comportement horizontal est décrit entre parenthèses.
- [1]
-
Si le bouton1 est enfoncé dans le creux, la valeur du scale sera
incrementée ou décrementée de la valeur de l'option resolution
et l'ascenseur se déplace dans la direction du curseur.
Si the bouton reste enfoncé, l'action se répète automatiquement.
- [2]
-
Si le bouton1 est enfoncé au-dessus de l'ascenseur, l'ascenseur peut être déplacé avec la souris.
- [3]
-
Si le bouton1 est enfoncé dans le creux avec la touche Control enfoncée,
l'ascenseur se déplace jusqu'à la fin de son étendue, dans le
direction du curseur de la souris.
- [4]
-
Si le bouton2 est enfoncé, la valeur du scale est fixé à la position de la souris. Si la souris est déplacée avec le bouton2 enfoncé, la valeur du scale change avec le déplacement.
- [5]
-
Les touches Haut et Gauche déplacent l'ascenseur vers le haut (la gauche) de la valeur de l'option résolution.
- [6]
-
Les touches Bas et Droite déplacent l'ascenseur vers le bas (la droite) de la valeur de l'option résolution.
- [7]
-
Control-Haut et Control-Gauche déplacent l'ascenseur vers le haut (la gauche) de la valeur de l'option bigIncrement.
- [8]
-
Control-Down et Control-Right déplacent l'ascenseur vers le bas (la droite) de la valeur de l'option bigIncrement.
- [9]
-
Home déplace l'ascenseur vers l'extrémité haute (gauche) de son étendue.
- [10]
-
End moves l'ascenseur vers l'extrémité basse (droite) de son étendue.
Si le scale est désactivé en utilisant l'option state alors
aucun des bindings ci-dessus n'ont d'effet.
Le comportement des scales peut être changé en définissant de nouveaux bindings pour des widgets individuels ou en redéfinissant les bindings de classe.
scale, slider, trough, widget
Copyright © 1990-1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 2003 - Le Portail Tcl/Tk Francophone.