  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

### NOM

options - Options standard supportées par les widgets

### DESCRIPTION

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.

### VOIR EGALEMENT

colors, cursors, font

### MOTS-CLES

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.