  NOM
    message - Crée et manipule les widgets de type message
  SYNTAXE
    message pathName ?options?
  OPTIONS STANDARDS
    -anchor, anchor, Anchor
    -background or -bg, background, Background
    -borderwidth or -bd, borderWidth, BorderWidth
    -cursor, cursor, Cursor
    -font, font, Font
    -foreground or -fg, foreground, Foreground
    -highlightbackground, highlightBackground, HighlightBackground
    -highlightcolor, highlightColor, HighlightColor
    -highlightthickness, highlightThickness, HighlightThickness
    -padx, padX, Pad
    -pady, padY, Pad
    -relief, relief, Relief
    -takefocus, takeFocus, TakeFocus
    -text, text, Text
    -textvariable, textVariable, Variable
    -width
  OPTIONS SPECIFIQUES
    -aspect, aspect, Aspect
    -justify, justify, Justify
    -width, width, Width
  DESCRIPTION
  COMMANDES DE WIDGET
    pathName cget option
    pathName configure ?option? ?value option value ...?
  BINDINGS PAR DEFAUT
  BUGS
  MOTS-CLES

### NOM

message - Crée et manipule les widgets de type message

### SYNTAXE

message pathName ?options?

### OPTIONS STANDARDS

-anchor, anchor, Anchor
-background or -bg, background, Background
-borderwidth or -bd, borderWidth, BorderWidth
-cursor, cursor, Cursor
-font, font, Font
-foreground or -fg, foreground, Foreground
-highlightbackground, highlightBackground, HighlightBackground
-highlightcolor, highlightColor, HighlightColor
-highlightthickness, highlightThickness, HighlightThickness
-padx, padX, Pad
-pady, padY, Pad
-relief, relief, Relief
-takefocus, takeFocus, TakeFocus
-text, text, Text
-textvariable, textVariable, Variable
-width

### OPTIONS SPECIFIQUES

Command-Line Name: -aspect
Database Name: aspect
Database Class: Aspect
  Spécifie une valeur entière positive ou nulle, indiquant le ratio d'aspect désiré du texte. Le ratio d'aspect vaut 100*largeur/hauteur. 100 signifie que le texte doit être aussi large que haut, 200 signifie qu'il doit être deux fois plus large que haut, 50 signifie qu'il doit être deux fois plus haut que large. Utilisé pour choisir la longueur de la ligne si l'option width n'est pas spécifiée. La valeur par défaut est 150.

Command-Line Name: -justify
Database Name: justify
Database Class: Justify
  Spécifie comment doivent être justifiée les lignes du texte. Cette option peut prendre l'une des valeurs left, center, ou right. La valeur par défaut est left. Cette options peut être utilisée avec les options anchor, aspect, padX, padY, et width afin de fournir une grande variété d'arrangement du texte dans la fenêtre. Les options aspect et width déterminent l'espace nécessaire pour afficher le texte sur l'écran. Les options anchor, padX, et padY déterminent l'endroit où la région rectangulaire correspondant est affiché dans la fenêtre du widget, et l'option justify détermine comment chaque ligne est affichée dans cette région rectangulaire. Par exemple, si anchor vaut e et justify vaut left, et si la fenêtre du widget est plus large que nécessaire pour afficher le texte, alors le texte est affiché de tel sorte que la limite gauche de chaque ligne est cadrée sur le bord gauche de la région, le bord droit de la plus longue ligne est à une distance padX du bord droit de la région, et la région est centrée verticalement dans la fenêtre.

Command-Line Name: -width
Database Name: width
Database Class: Width
  Spécifie la longueur des lignes dans la fenêtre. La valeur peut avoir n'importe laquelle des formes acceptées par Tk_GetPixels. Si la valeur de cette option est strictement positive, l'option aspect est ignorée, et l'option width détermine la longueur des lignes.

### DESCRIPTION

La commande message crée une nouvelle fenêtre (spécifiée par l'argument pathName) et crée un widget de type message à l'intérieur. Des options supplémentaires, décrites ci-dessus, peuvent être spécifiées sur la ligne de commande ou dans les options de la database, afin de configurer l'aspect du widget, comme par exemple la couleur, la police de caractère, le texte, ou le relief initial. La commande message retourne son argument pathName. Au moment où cette commande est appelée, il ne doit pas exister de fenêtre nommée pathName, mais le parent de pathName doit exister.

Un widget de type message est un widget qui affiche une chaîne de caractères. Ce widget a trois caractéristiques spéciales. Premièrement, il coupe les chaînes en lignes, afin de respecter le ration d'aspect spécifié. La coupure des lignes est faite entre deux mots, lorsque cela est possible (si en mot ne peut même pas tenir seul sur une ligne, il est affiché sur plusieurs lignes). Les caractères de nouvelle ligne (Newline) permettent de forcer la coupure des lignes; ils peuvent par exemple être utilisés pour laisser une ligne vide.

La deuxième caractéristique de ce widget est la justification des lignes. Le texte peut être affiché en étant justifié à gauche (chaque ligne commence sur le bord gauche de la fenêtre), centré, ou justifié à droite (chaque ligne fini sur le bord droit de la fenêtre).

La troisième caractéristique de ce widget est la gestion des caractères de contrôle et des caractères spéciaux non imprimables. Le caractère de tabulation est remplacé par suffisamment d'espace pour s'aligner avec la prochaine limite de 8 caractères. Le caractère de nouvelle ligne (Newlines) permet de couper les lignes. Les autres caractères de contrôle (code ASCII inférieur à 0x20) et les caractères non définis dans la police de caractère sont visualisés par la séquence de 4 caractères \x hh où hh est la valeur hexa-décimale à deux chiffres correspondant à ce caractère. Dans le cas inhabituel où la police de caractère ne contient pas l'un des caractères ``0123456789abcdef\x'', les caractères de contrôle et les caractères non définis ne sont pas affichés du tout.

### WIDGET COMMAND

La commande message crée une nouvelle commande Tcl dont le nom est pathName. Cette commande peut être utilisée pour effectuer de nombreuses opération sur le widget. Elle a la forme générale suivante :

    pathName option ?arg arg ...?

Option et args déterminent le comportement exacte de la commande. Les commandes suivantes sont possible pour les widgets de type message :

pathName cget option
  Retourne la valeur actuelle de l'option de configuration donnée par option. Option doit avoir l'une des valeurs acceptée par la commande message.

pathName configure ?option? ?value option value ...?
  Interroge ou modifie une option 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 plus d'informations sur le format de cette liste). Si option est spécifié sans value, la commande retourne une liste décrivant l'option nommée (cette liste est identique à la sous-liste correspondant à l'option spécifié, dans la liste retournée lors que option n'est pas spécifié). Si une ou plusieurs paires option-value sont spécifiées, la commande modifie l'option ou les options correspondantes du widget en leur donnant la valeur spécifiée; dans ce cas, la commande retourne une chaîne vide. Option peut avoir n'importe laquelle des valeurs acceptée par la commande message.

### BINDINGS PAR DEFAUT

Lorsqu'un widget de type message est créé, il n'a aucun binding par défaut : ces widgets ont été prévus pour n'effectuer que des sorties.

### BUGS

Les caractères de tabulation ne fonctionnent pas très bien lorsque le texte est centré ou justifié à droite. Le résultat le plus courant est une mauvaise justification de la ligne.

### MOTS-CLES

message, widget

    Copyright © 1990-1994 The Regents of the University of California.
    Copyright © 1994-1996 Sun Microsystems, Inc.

    Copyright © 2003 - Le Portail Tcl/Tk Francophone.