message

 

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


SYNTAXE

 message pathName ?options?

OPTIONS STANDARDS


 -anchor
 -background
 -borderwidth
 -cursor
 -font
 -foreground
 -highlightbackground
 -highlightcolor
 -highlightthickness
 -padx
 -pady
 -relief
 -takefocus
 -text
 -textvariable
 -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 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 base de données, 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 \xhhhh est la valeur hexadé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 ConfigWidg 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 DÉFAUT


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.


Traduit par Michel Salvagniac 2002-2003

Copyright © 2003 - Le Wiki Tcl/Tk Francophone.


Catégorie Manuel Tcl/Tk