- NOM
- radiobutton - Crée et manipule les widgets bouton radio
- SYNTAXE
- radiobutton pathName ?options?
- OPTIONS STANDARD
- -activebackground, activeBackground, Foreground
- -activeforeground, activeForeground, Background
- -anchor, anchor, Anchor
- -background ou -bg, background, Background
- -bitmap, bitmap, Bitmap
- -borderwidth ou -bd, borderWidth, BorderWidth
- -cursor, cursor, Cursor
- -disabledforeground, disabledForeground, DisabledForeground
- -font, font, Font
- -foreground ou -fg, foreground, Foreground
- -highlightbackground, highlightBackground, HighlightBackground
- -highlightcolor, highlightColor, HighlightColor
- -highlightthickness, highlightThickness, HighlightThickness
- -image, image, Image
- -justify, justify, Justify
- -padx, padX, Pad
- -pady, padY, Pad
- -relief, relief, Relief
- -takefocus, takeFocus, TakeFocus
- -text, text, Text
- -textvariable, textVariable, Variable
- -underline, underline, Underline
- -wraplength, wrapLength, WrapLength
- OPTIONS SPECIFIQUES AU WIDGET
- -commande, commande, Command
- -hauteur, hauteur, Height
- -indicatoron, indicatorOn, IndicatorOn
- -selectcolor, selectColor, Background
- -overrelief, overRelief, OverRelief
- -selectimage, selectImage, SelectImage
- -state, state, State
- -value, value, Value
- -variable, variable, Variable
- -width, width, Width
- DESCRIPTION
- COMMANDES DE WIDGET
- pathName cget option
- pathName configure ?option? ?valeur option valeur ...?
- pathName deselect
- pathName flash
- pathName invoke
- pathName select
- BINDINGS
- MOTS-CLES
radiobutton - Crée et manipule les widgets bouton radio
radiobutton pathName ?options?
- -activebackground, activeBackground, Foreground
- -activeforeground, activeForeground, Background
- -anchor, anchor, Anchor
- -background ou -bg, background, Background
- -bitmap, bitmap, Bitmap
- -borderwidth ou -bd, borderWidth, BorderWidth
- -cursor, cursor, Cursor
- -disabledforeground, disabledForeground, DisabledForeground
- -font, font, Font
- -foreground ou -fg, foreground, Foreground
- -highlightbackground, highlightBackground, HighlightBackground
- -highlightcolor, highlightColor, HighlightColor
- -highlightthickness, highlightThickness, HighlightThickness
- -image, image, Image
- -justify, justify, Justify
- -padx, padX, Pad
- -pady, padY, Pad
- -relief, relief, Relief
- -takefocus, takeFocus, TakeFocus
- -text, text, Text
- -textvariable, textVariable, Variable
- -underline, underline, Underline
- -wraplength, wrapLength, WrapLength
- Command-Line Name: -commande
- Database Name: commande
- Database Class: Command
- Indique une commande Tcl à associer au bouton radio. cette commande
est généralement appelée quand le bouton1 de la souris est relaché au-dessus du bouton radio. La variable globale du bouton(l'option -variable ) sera
mis à jour avant que la commande soit appelée.
- Command-Line Name: -height
- Database Name: height
- Database Class: Height
- Indique la hauteur désirée du bouton.
Si une image ou un bitmap est affiché dans le bouton alors la valeur est en
unités d'ecrans (c.a.d. n'importe quelle des formes acceptables par Tk_GetPixels);
pour le texte il est en lignes de texte.
Si cette option n'est pas spécifiée, la hauteur désirée du bouton est calculée
à partir de la taille de l'image, du bitmap ou du texte affiché à l'intérieur.
- Command-Line Name: -indicatoron
- Database Name: indicatorOn
- Database Class: IndicatorOn
- Indique si oui ou non l'indicateur doit être dessiné. Doit être une valeur booléenne correcte. Si faux, l'option relief est
ignorée et le relief du widget est toujours enfoncé si le widget est
sélectionné et èlevé autrement.
- Command-Line Name: -selectcolor
- Database Name: selectColor
- Database Class: Background
- Indique une couleur d'arrière-plan à utiliser quand le bouton est sélectionné.
Si indicatorOn est true alors la couleur s'applique à l'indicateur.
Sous Windows, cette couleur est utilisée comme arrière-plan pour l'indicateur
indépendemment de l'état de la sélection.
Si indicatorOn est false, cette couleur est utilisée comme arrière-plan
pour le widget entier, à la place de background ou activeBackground,
chaque fois que le widget est sélectionné.
Si spécifié comme chaîne vide alors aucune couleur spéciale n'est utilisée pour
l'affichage quand le widget est sélectionné.
- Command-Line Name: -overrelief
- Database Name: overRelief
- Database Class: OverRelief
- Indique un relief alternatif pour le radiobutton, à utiliser quand le
curseur de la souris est au dessus du widget. Cette option peut être utilisée pour créer
des barres de boutons, en configurant -relief flat -overrelief
raised. Si la valeur de cette option est une chaîne vide, alors aucun
relief alternatif n'est utilisé quand le curseur de la souris est au-dessus du radiobutton.
La chaîne vide est la valeur par défaut.
- Command-Line Name: -selectimage
- Database Name: selectImage
- Database Class: SelectImage
- Indique une image à afficher (à la place de l'option image)
quand le radiobutton est sélectionné.
Cette option est ignorée à moins que l' option image ait été
spécifiée.
- Command-Line Name: -state
- Database Name: state
- Database Class: State
- Indique un des trois états du radiobutton: normal, active,
ou disabled. Dans l'état normal le radiobutton est affiché en utilisant les
options foreground et background. L'état actif est
généralement utilisé quand le pointeur est au-dessus du radiobutton. Dans l'état actif
le radiobutton est affiché en utilisant les options activeForeground et
activeBackground. L'état désactivé signifie que le radiobutton
doit être insensible: les bindings par défaut refuseront d'activer
le widget et ignoreront les clics de souris.
Dans cet état les options disabledForeground et
background déterminent comment le radiobutton est affiché.
- Command-Line Name: -value
- Database Name: value
- Database Class: Value
- Indique la valeur à stocker dans la variable associée au bouton chaque fois qu'il
est sélectionné.
- Command-Line Name: -variable
- Database Name: variable
- Database Class: Variable
- Indique le nom de la variable globale à modifier chaque fois que ce bouton
est sélectionné. Les changements de cette variable sont répercutés sur l'état de selection du bouton.
Par défaut la valeur est selectedButton.
- Command-Line Name: -width
- Database Name: width
- Database Class: Width
- Indique la largeur désirée du bouton.
Si une image ou un bitmap est affiché dans le bouton, la valeur est en
unités d'ecrans (c.a.d. n'importe quelle des formes acceptables par Tk_GetPixels);
pour le texte il est en caractères.
Si cette option n'est pas spécifiée, la largeur désirée du bouton est calculée
à partir de la taille de l'image du bitmap ou du texte affiché à l'intérieur.
La commande radiobutton crée une nouvelle fenêtre (indiquée par l'argument
pathName ) en en fait un widget radiobutton.
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 radiobutton comme ses couleurs, fontes,
texte, et relief initial. La commande radiobutton retourne son
argumentpathName. A l'instant ou cette commande est appelée,
il ne doit pas exister de fenêtre nommée pathName, mais le
parent de pathName doit exister.
Un radiobutton est un widget qui affiche une chaîne de texte, un bitmap ou une image
et un diamant ou un cercle appelé un indicator.
Si du texte est affiché, il doit être d'une seule fonte, mais il
peut occuper plusieurs lignes à l'écran (s'il contient des newlines
ou si le retour à la ligne se produit à cause de l'option wrapLength) et
un des caractères peut être éventuellement souligné en utilisant l'option
underline. Un radiobutton a
tous les comportements d'un simple bouton: il peut s'afficher sous un d'entre trois différent aspects, conformément à l'option state;
il peut apparaître
èlevé, enfoncé, ou plat; il peut clignoter; et appelle
une commande Tcl chaque fois que le bouton 1 de la souris est enfoncé au-dessus du
bouton check.
De plus, les radiobuttons peuvent être selectionnés.
Si un radiobutton est sélectionné, l'indicateur est normalement
dessiné avec une apparence sélectionnée, et
la variable Tcl associée au radiobutton est positionnée sur une valeur particulière
(normalement 1).
Sous Unix, l'indicateur est dessiné avec un relief enfoncé et une
couleur spéciale. Sous Windows, l'indicateur est dessiné avec une marque circulaire.
Si le radiobutton n'est pas sélectionné, alors l'indicateur est dessiné avec une
apparence déselectionnée, et la variable associée est
fixée à une valeur différente (généralement 0).
Sous Unix, l'indicateur est dessiné avec un relief èlevé et aucune
couleur spéciale. Sous Windows, l'indicateur est dessiné sans marque circulaire.
Généralement, plusieurs radiobuttons partagent une seule variable et la
valeur de la variable indique quel radiobutton est sélectionné.
Quand un radiobutton est sélectionné, il fixe la valeur de la variable pour signaler
cet évènement; chaque radiobutton reflète la valeur de la
variable et se sélectionne et desélectionne lui-même automatiquement quand la
valeur de la variable change.
Par défaut la variable selectedButton
est utilisée; son contenu donne le nom du bouton qui est
sélectionné, ou une chaîne vide si aucun bouton associé à la
variable n'est sélectionné.
Le nom de la variable d'un radiobutton,
et la variable à stocker, peuvent être modifiés avec des options
sur la ligne de commande ou dans la base de données d'options.
Les options de configuration peuvent être également utilisées pour modifier la manière dont l'indicateur est affiché (ou s'il est simplement affiché).
Par défaut un radiobutton est configuré pour choisir lui-même pendant les clicks sur les boutons.
La commande radiobutton 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 les args
détermine le comportement exact de la commande. Les commandes suivantes
sont possibles pour les widgets radiobutton:
- 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 radiobutton.
- 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 une
information sur le format de cette liste). Si option est spécifié
sans valeur, 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és, 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 radiobutton.
- pathName deselect
-
Desélectionne le radiobutton et fixe la variable associée à une
chaîne vide.
Si ce radiobutton n'était pas actuellement sélectionné, la commande n'a pas
d'effet.
- pathName flash
-
Fait clignoter le radiobutton. Ceci est accompli en réaffichant le radiobutton
plusieurs fois, en alternant entre les couleurs active et normale. A
la fin du clignotage, le radiobutton est laissé dans le même état normal/active
que quand la commande a été appelée.
cette commande est ignorée si l'état du radiobutton est désactivé.
- pathName invoke
-
Fait juste ce qui se produit si l'utilisateur agit sur le radiobutton
avec la souris: sélectionne le bouton et appelle sa
commande Tcl associée, s'il y en a une.
La valeur de retour est la valeur de retour de la commande Tcl, ou une
chaîne vide s'il n'y a pas de commande associée au radiobutton.
cette commande est ignorée si l'état du radiobutton est désactivé.
- pathName select
-
Selectionne le radiobutton et fixe la variable associée à la
valeur correspondant à ce widget.
Tk automatiquement crée des bindings de classe pour les radiobuttons qui leurs donnent
le comportement par défaut suivant:
- [1]
-
Sur les systèmes Unix, un radiobutton s'active chaque fois que la souris passe
au-dessus et se désactive chaque fois que la souris quitte le radiobutton. Sur les
systèmes Mac et Windows, quand le bouton1 de la souris est enfoncé au-dessus d'un
radiobutton, le bouton s'active chaque fois que le pointeur de souris est dans
le bouton, et se désactive chaque fois que le pointeur de souris quitte le
bouton.
- [2]
-
Quand le bouton1 de la souris est enfoncé au-dessus d'un radiobutton il est appelée (il
est sélectionné et la commande associés au bouton est
appelée, s'il y en a une).
- [3]
-
Quand un radiobutton a le focus, un appui sur la barre d'espace provoque l'appel du radiobutton.
Si l'état du radiobutton est désactivé alors aucune des
actions ci-dessus ne se produit: le radiobutton est complètement inerte.
Le comportement des radiobuttons peut être changé en définissant de nouveaux bindings pour
des widgets individuels ou en redéfinissant les bindings de classe.
radiobutton, widget
Copyright © 1990-1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 1995-1997 Roger E. Critchlow Jr.
Traduit par Michel Salvagniac en 2003
Copyright © 2003 - Le Portail Tcl/Tk Francophone.