- 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
message - Crée et manipule les widgets de type message
message pathName ?options?
- -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
- 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.
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 \xhh
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.
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.
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.
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.
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.