- NOM
- options - Options standard supportées par les widgets
- DESCRIPTION
- -activebackground, activeBackground, Foreground
- -activeborderwidth, activeBorderWidth, BorderWidth
- -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
- -exportselection, exportSelection, ExportSelection
- -font, font, Font
- -foreground ou -fg, foreground, Foreground
- -highlightbackground, highlightBackground, HighlightBackground
- -highlightcolor, highlightColor, HighlightColor
- -highlightthickness, highlightThickness, HighlightThickness
- -image, image, Image
- -insertbackground, insertBackground, Foreground
- -insertborderwidth, insertBorderWidth, BorderWidth
- -insertofftime, insertOffTime, OffTime
- -insertontime, insertOnTime, OnTime
- -insertwidth, insertWidth, InsertWidth
- -jump, jump, Jump
- -justify, justify, Justify
- -orient, orient, Orient
- -padx, padX, Pad
- -pady, padY, Pad
- -relief, relief, Relief
- -repeatdelay, repeatDelay, RepeatDelay
- -repeatinterval, repeatInterval, RepeatInterval
- -selectbackground, selectBackground, Foreground
- -selectborderwidth, selectBorderWidth, BorderWidth
- -selectforeground, selectForeground, Background
- -setgrid, setGrid, SetGrid
- -takefocus, takeFocus, TakeFocus
- -text, text, Text
- -textvariable, textVariable, Variable
- -troughcolor, troughColor, Background
- -underline, underline, Underline
- -wraplength, wrapLength, WrapLength
- -xscrollcommand, xScrollCommand, ScrollCommand
- -yscrollcommand, yScrollCommand, ScrollCommand
- VOIR EGALEMENT
- MOTS-CLES
options - Options standard supportées par les widgets
Cette page décrit les options de configuration courantes supportées
par les widgets du toolkit Tk. Tous les widgets ne supportent pas nécessairement
chaque option (voir la page concernant le widget pour une liste
des options standard supportées par ce widget), mais si un widget
supporte une option ayant un des noms listés ci-dessous, alors l'option
a exactement l'effet décrit.
Dans les descriptions ci-dessous, ``Command-Line Name'' se réfère au
commutateur utilisé dans les commandes de classe et les commandes configure pour fixer
cette valeur. Par exemple, si le commutateur de la ligne de commande d'une option est
-foreground et qu'il existe un widget .a.b.c, alors la
commande
.a.b.c configure -foreground black
peut être utilisée pour spécifier la valeur black pour l'option dans le
le widget .a.b.c. Les commutateurs de la ligne de commande peuvent être abrégés,
tant que l'abréviation n'est pas ambigûe.
``Database Name'' se réfère au nom de l'option dans la base de données d'options (ex.
dans les fichiers .Xdefaults). ``Database Class'' se réfère à la valeur de la classe d'option
dans la base de données d'options.
- Command-Line Name: -activebackground
- Database Name: activeBackground
- Database Class: Foreground
- Spécifie la couleur d'arrière-plan à utiliser à l'affichage d'éléments actifs.
Un élément (un widget ou une partie d'un widget) est actif si le
curseur de la souris est positionné au-dessus de l'élément et que l'appui sur un bouton de la souris
provoque une action.
Si la compatibilité stricte avec Motif a été demandée en fixant la
variable tk_strictMotif, cette option sera normalement
ignorée; la couleur normale d'arrière-plan sera utilisée à la place.
Pour certains éléments sous Windows et Macintosh, la couleur active
sera utilisée seulement quand le bouton 1 de la souris est enfoncé au-dessus de l'élément.
- Command-Line Name: -activeborderwidth
- Database Name: activeBorderWidth
- Database Class: BorderWidth
- Spécifie une valeur non négative indiquant
la largeur de la bordure 3-D dessinée autour des éléments actifs. Voir ci-dessous pour une
définition des éléments actifs.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
Cette option est généralement seulement disponible dans les widgets affichant plus
d'un élément à la fois (ex. les menus mais pas les boutons).
- Command-Line Name: -activeforeground
- Database Name: activeForeground
- Database Class: Background
- Spécifie la couleur de premier plan à utiliser à l'affichage d'éléments actifs.
Voir ci-dessous pour une
définition des éléments actifs.
- Command-Line Name: -anchor
- Database Name: anchor
- Database Class: Anchor
- Spécifie ou l'information (ex. texte ou bitmap)
est affichée dans le widget.
Doit être une des valeurs n, ne, e, se,
s, sw, w, nw, ou center.
Par exemple, nw signifie que l'information est dans le coin supérieur gauche du widget.
- Command-Line Name: -background ou -bg
- Database Name: background
- Database Class: Background
- Spécifie la couleur normale d'arrière-plan à utiliser à l'affichage du
widget.
- Command-Line Name: -bitmap
- Database Name: bitmap
- Database Class: Bitmap
- Spécifie le bitmap à afficher dans le widget, sous n'importe quelle des formes
acceptable par Tk_GetBitmap.
la manière exacte de laquellle le bitmap est affiché peut être modifiée par
d'autres options comme anchor ou justify.
Généralement, si cette option est spécifiée alors elle écrase les autres
options qui indiquent la valeur du texte à afficher dans le widget;
l'option bitmap peut être réinitialisée à une chaîne vide pour réactiver
l'affichage de texte.
Dans les widgets qui supportent à la fois les options bitmap et image,
image écrase généralement bitmap.
- Command-Line Name: -borderwidth ou -bd
- Database Name: borderWidth
- Database Class: BorderWidth
- Spécifie une valeur non négative indiquant la largeur
de la bordure 3-D tout autour du widget (si une telle
bordure est dessinée; l'option relief détermine généralement
ceci). La valeur peuvent être également utilisée pendant le dessin d'effets 3-D à l'intérieur
du widget.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
- Command-Line Name: -cursor
- Database Name: cursor
- Database Class: Cursor
- Spécifie le curseur de souris à utiliser pour le widget.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetCursor.
- Command-Line Name: -disabledforeground
- Database Name: disabledForeground
- Database Class: DisabledForeground
- Spécifie la couleur de premier plan à utiliser à l'affichage d'un élément désactivé.
Si l'option est spécifiée comme une chaîne vide (ce qui sera généralement le
cas avec les écrans monochromes), les éléments désactivés sont dessinés avec la
couleur de premier plan normale mais ils sont foncés avec des pointillés.
- Command-Line Name: -exportselection
- Database Name: exportSelection
- Database Class: ExportSelection
- Spécifie si oui ou non la sélection dans le widget doit être également
la sélection X.
La valeur doit avoir n'importe quelle des formes acceptées par Tcl_GetBoolean,
comme true, false, 0, 1, yes, ou no.
Si la sélection est exportée, alors une sélection dans le widget desélectionne
la sélection X courante, une sélection en dehors du widget desélectionne toute
sélection widget, et le widget répondra aux demandes de récupération de sélection. La valeur par défaut est généralement sur export.
- Command-Line Name: -font
- Database Name: font
- Database Class: Font
- Spécifie la police de caractère à utiliser à l'affichage de texte dans le widget.
La valeur doit avoir n'importe quelle des formes acceptées par Tk_GetFont.
- Command-Line Name: -foreground ou -fg
- Database Name: foreground
- Database Class: Foreground
- Spécifie la couleur de premier plan normale à utiliser à l'affichage du widget.
- Command-Line Name: -highlightbackground
- Database Name: highlightBackground
- Database Class: HighlightBackground
- Spécifie la couleur à afficher dans une zone en surbrillance quand
le widget n'a pas le focus.
- Command-Line Name: -highlightcolor
- Database Name: highlightColor
- Database Class: HighlightColor
- Spécifie la couleur à utiliser pour le rectangle en surbrillance
dessiné autour du widget quand il a le focus.
- Command-Line Name: -highlightthickness
- Database Name: highlightThickness
- Database Class: HighlightThickness
- Spécifie une valeur non négative indiquant la largeur du
rectangle en surbrillance à dessiner à l'exterieur du widget quand il a le
focus d'entée.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
Si la valeur est zéro, aucune surbrillance n'est dessinée autour du widget.
- Command-Line Name: -image
- Database Name: image
- Database Class: Image
- Spécifie une image à afficher dans le widget, qui aura été
créée avec la commande image create.
Généralement, si l'option image est spécifiée alors elle écrase les autres
options qui indiquent un bitmap ou une valeur textuelle à afficher dans le widget;
l'option image peut être réinitialisée à une chaîne vide pour réactiver
un bitmap ou un texte.
- Command-Line Name: -insertbackground
- Database Name: insertBackground
- Database Class: Foreground
- Spécifie la couleur à utiliser comme arrière-plan dans la zone couverte par le
curseur d'insertion. Cette couleur ecrasera normalement l'arrière-plan normal
du widget (ou la l'arrière-plan de la sélection si le curseur d'insertion
pénêtre dans la sélection).
- Command-Line Name: -insertborderwidth
- Database Name: insertBorderWidth
- Database Class: BorderWidth
- Spécifie une valeur non négative indiquant la largeur
de la bordure 3-D déssinée autour du curseur d'insertion.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
- Command-Line Name: -insertofftime
- Database Name: insertOffTime
- Database Class: OffTime
- Spécifie une valeur non négative entière indiquant le nombre de
millisecondes ou le curseur d'insertion est ``éteint'' dans chaque cycle de clignotement.
Si cette option est à zéro alors le curseur ne clignote pas: il est ``allumé''
tout le temps.
- Command-Line Name: -insertontime
- Database Name: insertOnTime
- Database Class: OnTime
- Spécifie une valeur non négative entière indiquant le nombre de
millisecondes où le curseur d'insertion doit rester ``allumé'' chaque cycle de clignotement.
- Command-Line Name: -insertwidth
- Database Name: insertWidth
- Database Class: InsertWidth
- Spécifie a valeur indiquant la largeur totale du curseur d'insertion.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
Si une bordure a été spécifiée pour le curseur d'insertion
(en utilisant l'option insertBorderWidth), cette bordure
sera dessinée dans la largeur spécifiée par l'option insertWidth.
- Command-Line Name: -jump
- Database Name: jump
- Database Class: Jump
- Pour les widgets avec un ascenseur qui peut être glissé pour ajuster une valeur,
comme des barres de défilement, cette option détermine quand les
notifications du changement de valeur sont effectuées.
La valeur de l'option doit être un booléen de la forme acceptée par
Tcl_GetBoolean.
Si la valeur est fausse, les mises à jour de l'affichage se produisent continuellement pendant le déplacement
de l'ascenseur.
Si la valeur est vraie, les mises à jour de l'affichage sont différées jusqu'au relachement du bouton de la souris
à la fin du déplacement; à ce point une seule notification
est faite (la valeur ``saute'' au lieu de changer régulièrement).
- Command-Line Name: -justify
- Database Name: justify
- Database Class: Justify
- Quand il y a de multiples lignes de texte affichées dans un widget, cette
option détermine comment les lignes sont organisées entre elles.
Doit être un parmi left, center, ou right.
Left signifie que les lignes sont justifiées à gauche, center
signifie que the lignes sont centrées, et right signifie que
les lignes sont justifiées à droite.
- Command-Line Name: -orient
- Database Name: orient
- Database Class: Orient
- Pour les widgets qui peuvent être diposés avec une orientation soit horizontale
soit verticale, comme les scrollbars, cette option indique
l'orientation doit être utilisée. Doit être soit horizontal
soit vertical ou une abréviation de l'une des deux.
- Command-Line Name: -padx
- Database Name: padX
- Database Class: Pad
- Spécifie une valeur non négative indiquant combien d'espace additionel
exiger pour le widget dans la direction X.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
Pendant le calcul de la largeur d'une fenêtre, le widget ajoutera
cette valeur à la largeur normalement requise (comme determiné
par la largeur des articles affichés dans le widget); si le gestionnaire de géométrie
peut satisfaire cette demande, le widget sera rempli avec un espace supplémentaire
à gauche et/ou à droite de ce qu'il affiche.
La plupart des widgets utilisent cette option seulement pour le remplissage de texte: si ils
affichent un bitmap ou une image, ils ignorent généralement les
options de remplissage.
- Command-Line Name: -pady
- Database Name: padY
- Database Class: Pad
- Spécifie une valeur non négative indiquant combien espace additionel
exiger pour le widget dans la direction Y.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
Pendant le calcul de la hauteur d'une fenêtre, le widget ajoutera
cette valeur à la hauteur normalement requise(comme déterminé par
la hauteur des articles affichés dans le widget); si le gestionnaire de géométrie peut satisfaire cette demande, le widget sera rempli avec un espace supplémentaire interne au dessus et/ou au dessous de ce qu'il affiche.
La plupart des widgets utilisent cette option seulement pour le remplissage de texte: si ils
affichent un bitmap ou une image, ils ignorent généralement les
options de remplissage.
- Command-Line Name: -relief
- Database Name: relief
- Database Class: Relief
- Spécifie l'effet 3-D désiré pour le widget. Les valeurs acceptables
sont raised, sunken, flat, ridge,
solid, et groove.
La valeur
indique comment l'intérieur du widget doit apparaître relativement
à son extérieur; par exemple, raised signifie que l'intérieur du
widget doit apparaître proéminent vers l'écran, relativement à
l'extérieur du widget.
- Command-Line Name: -repeatdelay
- Database Name: repeatDelay
- Database Class: RepeatDelay
- Spécifie le nombre de millisecondes où un bouton ou une touche doit être enfoncé
avant qu'il commence une auto repétition. Utilisé, par exemple, par les flèches
haut et bas des barres de défilement.
- Command-Line Name: -repeatinterval
- Database Name: repeatInterval
- Database Class: RepeatInterval
- Utilisé en conjonction avec repeatDelay: une fois que l'auto repétition
commence, cette option détermine le nombre de millisecondes entre
les répétitions.
- Command-Line Name: -selectbackground
- Database Name: selectBackground
- Database Class: Foreground
- Spécifie la couleur d'arrière-plan à utiliser à l'affichage d'articles sélectionnés.
- Command-Line Name: -selectborderwidth
- Database Name: selectBorderWidth
- Database Class: BorderWidth
- Spécifie une valeur non négative indiquant la largeur
de la bordure 3-D dessinée autour des articles sélectionnés.
La valeur doit avoir n'importe quelle des formes acceptables par Tk_GetPixels.
- Command-Line Name: -selectforeground
- Database Name: selectForeground
- Database Class: Background
- Spécifie la couleur de premier plan à utiliser à l'affichage d'articles sélectionnés.
- Command-Line Name: -setgrid
- Database Name: setGrid
- Database Class: SetGrid
- Spécifie a valeur booléenne qui détermine si le widget contrôle la grille
de taille de sa fenêtre top-level.
Cette option est généralement utilisée dans les widgets texte, ou l'information
dans le widget a une taille naturelle (la taille du caractère) et il est
sensé que les dimensions de la fenêtre soient des multiples entiers de ces unités.
Ces tailles de fenêtre naturelles forment une grille.
Si l'option setGrid est à true alors le widget
communiquera avec le gestionnaire de fenêtres et quand l'utilisateur change la taille
de la fenêtre top-level qui contient le widget, les dimensions de
la fenêtre seront affichées à l'utilisateur en unités de grille et la taille de la fenêtre
sera contrainte en unités entières de grille.
Voir la section GESTION DE LA GEOMETRIE DES GRILLES dans le manuel à wm
pour plus de détails.
- Command-Line Name: -takefocus
- Database Name: takeFocus
- Database Class: TakeFocus
- Determines si la fenêtre accepte le focus pendant les "keyboard
traversal" (ex., Tab et Shift-Tab).
Avant de donner le focus à une fenêtre, les scripts "traversal"
consultent la valeur de l'option takeFocus.
Une valeur de 0 signifie que la fenêtre doit être sautée entièrement
pendant les "keyboard traversal".
1 signifie que la fenêtre recevra le
focus tant qu'elle est visible (elle et tous ses ancêtres sont assignés).
Une valeur vide pour l'option signifie que les scripts traversal prennent
la décision si oui ou non le focus est sur la fenêtre: l'algorithme courant
saute la fenêtre si elle est
désactivée, s'il n'y a pas de bindings de touches, ou si elle n'est pas visible.
Si la valeur a n'importe quelle autre forme, alors les scripts traversal prennent
la valeur, y ajoutent le nom de la fenêtre (avec un espace comme separateur),
et evaluent la chaîne resultante comme un script Tcl.
Le script doit retourner 0, 1, ou une chaîne vide: une valeur de
0 ou 1 indique si la fenêtre recevra
le focus, et une chaîne vide donne la décision par défaut
décrite ci-dessus.
Note: cette interprètation de l'option est définie entièrement par
les scripts Tcl qui implémentent traversal: l'implementations widget
ignore entièrement l'option, donc vous pouvez changer son sens si vous
redefinissez les scripts "traversal".
- Command-Line Name: -text
- Database Name: text
- Database Class: Text
- Spécifie une chaîne affichée dans le widget. La façon de laquelle
la chaîne est affichée depend du widget et peut être
déterminée par d'autre options, comme anchor ou justify.
- Command-Line Name: -textvariable
- Database Name: textVariable
- Database Class: Variable
- Spécifie le nom d'une variable. La valeur de la variable est une
chaîne affichée dans le widget; si la valeur de la variable change
alors le widget se met automatiquement à jour pour refléter la nouvelle valeur.
La façon de laquelle la chaîne est affichée dans le widget depend du
widget et peut être déterminée par d'autre options, comme
anchor ou justify.
- Command-Line Name: -troughcolor
- Database Name: troughColor
- Database Class: Background
- Spécifie la couleur à utiliser pour les zones rectangulaires
dans les widgets comme les barres de défilement et les echelles. Cette option est ignorée par
les barres de défilement sous Windows (les widgets natifs ne reconnaissent pas cette option).
- Command-Line Name: -underline
- Database Name: underline
- Database Class: Underline
- Spécifie l'index entier d'un caractère à souligner dans le widget.
Cette option est utilisée par les bindings par défaut pour implémenter keyboard
traversal des boutons de menu et des entrées de menu.
0 corresponds au premier caractère du texte affiché dans le
widget, 1 au caractère suivant, et ainsi de suite.
- Command-Line Name: -wraplength
- Database Name: wrapLength
- Database Class: WrapLength
- Pour les widgets qui supportent le retour à la ligne, cette option indique
la longueur de ligne maximum.
Les lignes qui dépassent cette longueur sont renvoyées sur la ligne suivante,
ainsi aucune ligne n'est plus longue que la longueur spécifiée.
La valeur peut être spécifiée sous n'importe quelle des formes standard des
distances écran.
Si cette valeur est inférieure ou égale à 0 alors aucun renvoi n'est effectué: les lignes
retournent seulement aux caractères newline dans le texte.
- Command-Line Name: -xscrollcommand
- Database Name: xScrollCommand
- Database Class: ScrollCommand
- Spécifie le prefixe de la commande utilisée pour communiquer avec les les barres de défilement horizontales.
Quand la vue dans la fenêtre du widget change (ou
chaque fois que quelque chose d'autre se produit qui peut changer l'affichage dans une
barre de défilement, comme un changement dans la taille totale du contenu du widget), le widget
genèrera une commande Tcl en concatenant la commande de défilement et
deux nombres.
Chacun des nombres est une fraction entre 0 et 1, qui indique
une position dans le document. 0 indique le début du document,
1 indique la fin, .333 indique une position au tiers du
document, et ainsi de suite.
La première fraction indique la premier information dans le document
qui est visible dans la fenêtre, et la seconde fraction indique
l'information juste après la dernière portion visible.
La commande est
alors transmise à l'interpréteur Tcl pour exécution. Généralement l'option
xScrollCommand consiste en le nom de chemin d'une barre de défilement
suivi par ``set'', ex. ``.x.scrollbar set'': ceci provoque
la mise à jour de la barre de défilement chaque fois que la vue dans la fenêtre change.
Si cette option n'est pas spécifiée, alors aucune commande ne sera exécutée.
- Command-Line Name: -yscrollcommand
- Database Name: yScrollCommand
- Database Class: ScrollCommand
- Spécifie le prefixe de la commande utilisée pour communiquer avec les barres de défilement verticales. Cette option est traitée de la même façon que l'option
xScrollCommand, excepté qu'elle est utilisée pour les barres de défilement
verticales et est fournie pour les widgets qui supportent le défilement vertical.
Voir la description de xScrollCommand pour les détails
de comment cette option est utilisée.
colors, cursors, font
class, NOM, standard option, switch
Copyright © 1990-1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 1995-1997 Roger E. Critchlow Jr.
Copyright © 2003 - Le Portail Tcl/Tk Francophone.