## Tcl9.0.3/Tk9.0.3 Documentation > Tk Commands > message

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    message — '伝言文' 非対話機能文書部品の創生と操作 Create and manipulate 'message' non-interactive text widgets
  構文 SYNOPSIS
  STANDARD 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
  部品固有の指示項目WIDGET-SPECIFIC OPTIONS
    -aspect, aspect, Aspect
    -justify, justify, Justify
    -width, width, Width
  説明 DESCRIPTION
  部品命令 WIDGET COMMAND
    pathName cget option
    pathName configure ?option? ?value option value ...?
  省略時設定の束縛 　DEFAULT BINDINGS
  瑕疵 BUGS
  SEE ALSO
  KEYWORDS

### NAME

message — '伝言文' 非対話機能文書部品の創生と操作 Create and manipulate 'message' non-interactive text widgets

### 構文 SYNOPSIS

message pathName ?options?

### STANDARD 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

### 部品固有の指示項目WIDGET-SPECIFIC OPTIONS

Command-Line Name: -aspect
Database Name: aspect
Database Class: Aspect
  文書の為の望ましい縦横比を指し示す非負の整数値を指定する｡縦横比は 100*幅/高さとして指定する｡100 の意味は文書はその高さと同じ広さの幅である｡ 200 の意味は文書は高さの倍の幅である｡ 50 の意味は文書は幅の倍の高さであり､以下同様である｡もし width 指示項目が指定されていない場合､文書の為の行の長さを選ぶ為に使われる｡省略時設定は 150 ｡ Specifies a non-negative integer value indicating desired aspect ratio for the text. The aspect ratio is specified as 100*width/height. 100 means the text should be as wide as it is tall, 200 means the text should be twice as wide as it is tall, 50 means the text should be twice as tall as it is wide, and so on. Used to choose line length for text if -width option is not specified. Defaults to 150.

Command-Line Name: -justify
Database Name: justify
Database Class: Justify
  文書の行を如何に揃えるかを指定する｡ left か center か right かの内の一つでなければならない｡省略時設定は left ｡この指示項目は -anchor か -aspect か -padX か -padY か -width の指示項目と一緒に動作し窓内の文書に種々の配列を提供する｡ -aspect と -width 指示項目はその文書を表示する為に必要な画面の空間の量を定める｡-anchor と -padX と -padY 指示項目はこの矩形領域を表示する部品窓内部の位置を定める､又 -justify 指示項目はその矩形領域内に如何に行を表示するかを定める｡譬ば､ -anchor が e で -justify が left であって､伝言窓が文書に必要な大きさより大きいと仮定する｡その文書は全ての行の左端が揃う様に､且つ最長行の右端が窓の側面から -padX になる様に; 全体の文書の塊が窓の縦の範囲の真ん中になる様に､表示される｡ 　 Specifies how to justify lines of text. Must be one of left, center, or right. Defaults to left. This option works together with the -anchor, -aspect, -padx, -pady, and -width options to provide a variety of arrangements of the text within the window. The -aspect and -width options determine the amount of screen space needed to display the text. The -anchor, -padx, and -pady options determine where this rectangular area is displayed within the widget's window, and the -justify option determines how each line is displayed within that rectangular region. For example, suppose -anchor is e and -justify is left, and that the message window is much larger than needed for the text. The text will be displayed so that the left edges of all the lines line up and the right edge of the longest line is -padx from the right side of the window; the entire text block will be centered in the vertical span of the window.

Command-Line Name: -width
Database Name: width
Database Class: Width
  窓内の行の長さを指定する｡値は Tk_GetPixels に受入れられるどの形式を有していても良い｡もしこの指示項目が零より大きい値を有する場合､ -aspect 指示項目は無視され -width 指示項目が行の長さを定める｡もしこの指示項目が零かそれより小さい値を有する場合､ -aspect 指示項目が行の長さを定める｡ Specifies the length of lines in the window. The value may have any of the forms acceptable to Tk_GetPixels. If this option has a value greater than zero then the -aspect option is ignored and the -width option determines the line length. If this option value is negative or zero, then the -aspect option determines the line length.

### 説明 DESCRIPTION

message 命令は(与えられたpathName 引数によって)新しい窓を生成し､それを伝達文部品にする｡上に述べた追加的な指示項目は命令行或は､その色や字形や文書や立体感の様な伝達文の外観を構成設定する追加的な基礎データの中で指定される｡message 命令はそのpathName 引数を返す｡この命令が起動された時､ pathName の名前の窓が存在してはならないが､pathName の親は存在しなければならない｡ The message command creates a new window (given by the pathName argument) and makes it into a message widget. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the message such as its colors, font, text, and initial relief. The message command returns its pathName argument. At the time this command is invoked, there must not exist a window named pathName, but pathName's parent must exist.

伝達文は文書的な文字列を表示する部品である｡伝達文部品は三つの特別な性質を有する点が名札部品labelと異なっている｡第１､それは与えられた窓の縦横比を実現する為に文書の行を分割する｡行の分割はどこであれ､分割可能な語の境界を選択する(もし一だけの単語でさえ行内に嵌らない場合､その単語が行に跨って分割される)｡文字列内の改行文字は行の分割を強要する; それは､譬えば空白行を展示内に残す為には便利である｡ A message is a widget that displays a textual string. A message widget has three special features that differentiate it from a label widget. First, it breaks up its string into lines in order to produce a given aspect ratio for the window. The line breaks are chosen at word boundaries wherever possible (if not even a single word would fit on a line, then the word will be split across lines). Newline characters in the string will force line breaks; they can be used, for example, to leave blank lines in the display.

第２の伝達文部品の性質は揃えである｡その文書は左揃えで表示されるかもしれず(それぞれの行が窓の左の側面で始まる)､行から行へ作成され､右揃え(それぞれの行が窓の右の側面で終る)かもしれない｡ The second feature of a message widget is justification. The text may be displayed left-justified (each line starts at the left side of the window), centered on a line-by-line basis, or right-justified (each line ends at the right side of the window).

第３の伝達文部品の性質は制御文字特に非印刷文字の処理である｡タブ文字は次の８文字の境界への十分な空白を置く｡改行文字は行を分割する｡他の制御文字(0x20 よりも小さいASCII 番号)と､文字形状に定義されない文字は４つの文字並び hh として表示される､ここで hh は文字に相当する二つの十六進数である｡通常ではない場合､そこでは文字形状が “0123456789abcdef\x” の全ての文字を含んでいないと制御文字と非印刷文字は全く表示されない｡ The third feature of a message widget is that it handles control characters and non-printing characters specially. Tab characters are replaced with enough blank space to line up on the next 8-character boundary. Newlines cause line breaks. Other control characters (ASCII code less than 0x20) and characters not defined in the font are displayed as a four-character sequence \x hh where hh is the two-digit hexadecimal number corresponding to the character. In the unusual case where the font does not contain all of the characters in “0123456789abcdef\x” then control characters and undefined characters are not displayed at all.

### 部品命令 WIDGET COMMAND

message 命令は pathName と言う名前の新しい Tcl 命令を生成する｡この命令は部品上の種々の指示項目を起動する為に使うことができる｡それは次の一般式を有する: The message command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:

    pathName option ?arg ...?

option と arg は命令の正確な振舞いを定める｡次の命令が伝言文部品について可能である: Option and the args determine the exact behavior of the command. The following commands are possible for message widgets:

pathName cget option
  option で与えられる構成設定できる指示項目の値を返す｡ option はmessage 命令により受入れられるどの様な形式でもよい｡ Returns the current value of the configuration option given by option. Option may have any of the values accepted by the message command.

pathName configure ?option? ?value option value ...?
  部品の構成設定できる指示項目の値を問合せ又は修正する｡もし option が指定されないと､ pathName について利用できる全ての指示項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､その名前の指示項目を記述したリストが返る(このリストは､ option を指定しない時に返るリストの部分リストになっている)｡もし､一つ或はそれ以上の option-value 対が指定されると､命令は､与えられた指示項目を与えられた値に修正する; この場合､命令は空文字列を返す｡ option はmessage 命令が受入れるどの値を有していてもよい｡ Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for pathName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the message command.

### 省略時設定の束縛 　DEFAULT BINDINGS

新しい伝達文が作成された時､それは省略時設定の行事束縛は有していない: 伝達文は出力の目的のみに解釈される｡ When a new message is created, it has no default event bindings: messages are intended for output purposes only.

### 瑕疵 BUGS

タブは文書が中心揃え或は右揃えの場合巧く働かない｡代表的な症状は行揃えが変になる｡ Tabs do not work very well with text that is centered or right-justified. The most common result is that the line is justified wrong.

### SEE ALSO

label

### KEYWORDS

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