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

### 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
    options — 部品に運営されている標準指示項目 Standard options supported by widgets
  DESCRIPTION
    -activebackground, activeBackground, Foreground
    -activeborderwidth, activeBorderWidth, BorderWidth
    -activeforeground, activeForeground, Background
    -activerelief, activeRelief, Relief
    -anchor, anchor, Anchor
    -background or -bg, background, Background
    -bitmap, bitmap, Bitmap
    -borderwidth or -bd, borderWidth, BorderWidth
    -cursor, cursor, Cursor
    -compound, compound, Compound
    -disabledforeground, disabledForeground, DisabledForeground
    -exportselection, exportSelection, ExportSelection
    -font, font, Font
    -foreground or -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
    -placeholder, placeHolder, PlaceHolder
    -placeholderforeground, placeholderForeground, PlaceholderForeground
    -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
  SEE ALSO
  KEYWORDS

### NAME

options — 部品に運営されている標準指示項目 Standard options supported by widgets

### DESCRIPTION

この取扱説明書の見出しは Tk 内の部品によって運営されている共通の構成設定指示項目を記述する｡全ての部品が全ての指示項目を運営する必要はないが(個別の部品については取扱説明書の見出しの､その部品に運営されている標準指示項目のリストを参照されたい)､もし下に列挙した名前の内の一つの指示項目を運営している場合は､その指示項目は下に記述した効果を正確に有する｡ This manual entry describes the common configuration options supported by widgets in the Tk toolkit. Every widget does not necessarily support every option (see the manual entries for individual widgets for a list of the standard options supported by that widget), but if a widget does support an option with one of the names listed below, then the option has exactly the effect described below.

下に記述した “命令行の名前” は級命令内で切替えに､又この値を設定するために configure 部品命令を使う｡譬えば､もし指示項目の命令行切替えは -foreground であり､部品 .a.b.c が存在すると次の命令の In the descriptions below, “Command-Line Name” refers to the switch used in class commands and configure widget commands to set this value. For example, if an option's command-line switch is -foreground and there exists a widget .a.b.c, then the command

    .a.b.c  configure  -foreground black

は値 black を部品 .a.b.c 内の指示項目の為の値の設定に使用できる｡命令行切り替えは短縮が不明瞭にならない限り短縮記述できる｡ “Database Name” は指示項目基本データの指示項目の名前を参照する(譬えば､ .Xdefaults 内のファイル)｡ “Database Class” は指示項目基本データの指示項目の級の値を参照する｡ may be used to specify the value black for the option in the widget .a.b.c. Command-line switches may be abbreviated, as long as the abbreviation is unambiguous. “Database Name” refers to the option's name in the option database (e.g. in .Xdefaults files). “Database Class” refers to the option's class value in the option database.

Command-Line Name: -activebackground
Database Name: activeBackground
Database Class: Foreground
  活性な要素を描く時に背景の色を設定する｡もしマウス遊走子がその要素の上に位置される場合は､要素は(部品又は部品の一部)活性である､そしてマウス釦を押すと何かの活動が生じる｡もし厳密に Motif を遵守する場合は tk_strictMotif 変数を設定しておくことが要求される､この指示項目は通常は無視される; 通常の背景の色が代りに使用される｡Windows と マッキントッシュの系のどれかの要素では､活性な色はマウス釦 1 がその要素の上で押される間のみ使用される｡ Specifies background color to use when drawing active elements. An element (a widget or portion of a widget) is active if the mouse cursor is positioned over the element and pressing a mouse button will cause some action to occur. If strict Motif compliance has been requested by setting the tk_strictMotif variable, this option will normally be ignored; the normal background color will be used instead. For some elements on Windows and Macintosh systems, the active color will only be used while mouse button 1 is pressed over the element.

Command-Line Name: -activeborderwidth
Database Name: activeBorderWidth
Database Class: BorderWidth
  活性な要素の回りに立体的な縁を描いた幅を指し示す非負の値を設定する｡活性な要素の定義については上を参照されたい｡その値は Tk_GetPixels に受入可能などのような形式でも有し得る｡この指示項目は典型的には同時に複数の要素を表示する部品内でのみ使用できる(譬えば､釦以外の指示項目聚)｡ Specifies a non-negative value indicating the width of the 3-D border drawn around active elements. See above for definition of active elements. The value may have any of the forms acceptable to Tk_GetPixels. This option is typically only available in widgets displaying more than one element at a time (e.g. menus but not buttons).

Command-Line Name: -activeforeground
Database Name: activeForeground
Database Class: Background
  活性な要素を描く時に使う色を指定する｡活性な要素の定義については上を参照されたい｡ Specifies foreground color to use when drawing active elements. See above for definition of active elements.

Command-Line Name: -activerelief
Database Name: activeRelief
Database Class: Relief
  部品の活性品目に関する望ましい立体的効果を指定する｡詳細は -relief 指示項目を参照されたい｡ Specifies the 3-D effect desired for the active item of the widget. See the -relief option for details.

Command-Line Name: -anchor
Database Name: anchor
Database Class: Anchor
  部品内に如何に部品(譬えば､文書や点地図)が表示されるかの情報を設定する｡値は n か ne か e か se か s か sw か w か nw か center の内の一つでなければならない｡譬えば､ nw の意味は､その左上隅が部品の左上隅であるような表示の情報である｡ (訳注 画面を地図に見立てて東西南北で方向を示す n:北/上, ne:東北/右上, e:東/右, se:南東/右下, s:南/下, sw:西南/左下, w:西/左, nw:西北/左上, center:中央) Specifies how the information in a widget (e.g. text or a bitmap) is to be displayed in the widget. Must be one of the values n, ne, e, se, s, sw, w, nw, or center. For example, nw means display the information such that its top-left corner is at the top-left corner of the widget.

Command-Line Name: -background or -bg
Database Name: background
Database Class: Background
  部品を表示する時に使う通常の背景色を指定する｡ Specifies the normal background color to use when displaying the widget.

Command-Line Name: -bitmap
Database Name: bitmap
Database Class: Bitmap
  部品内に表示する点地図を､ Tk_GetBitmap に受入可能などのような形式かで指定する｡他の -anchor や -justify の様な指示項目に影響されて点地図が表示される正確な方法である｡典型的には､もしこの指示項目が指定されると､それは部品内に表示しする為に指定された他の文書値に上書きされるが､これは -compound 指示項目により制御される; この -bitmap 指示項目は文書表示を再度可能にする為に､空文字列に刷新され得る｡ -bitmap と -image 指示項目の両方を運営する部品内では､通常 -image は -bitmap を上書きする｡ Specifies a bitmap to display in the widget, in any of the forms acceptable to Tk_GetBitmap. The exact way in which the bitmap is displayed may be affected by other options such as -anchor or -justify. Typically, if this option is specified then it overrides other options that specify a textual value to display in the widget but this is controlled by the -compound option; the -bitmap option may be reset to an empty string to re-enable a text display. In widgets that support both -bitmap and -image options, -image will usually override -bitmap.

Command-Line Name: -borderwidth or -bd
Database Name: borderWidth
Database Class: BorderWidth
  部品の外の回りに立体的な縁を描いた幅を指し示す非負の値を設定する(もしこのような境界が描かれている場合; relief 指示項目がこれを定めている)｡値は部品の内部の立体的効果を描くときにも使い得る｡その値は Tk_GetPixels に受入可能などのような形式でも有し得る｡ Specifies a non-negative value indicating the width of the 3-D border to draw around the outside of the widget (if such a border is being drawn; the -relief option typically determines this). The value may also be used when drawing 3-D effects in the interior of the widget. The value may have any of the forms acceptable to Tk_GetPixels.

Command-Line Name: -cursor
Database Name: cursor
Database Class: Cursor
  部品の為に使われるマウス遊走子を指定する｡その値は Tk_GetCursor に受入可能などのような形式でも有し得る｡更に､空文字列であるとそれは部品が遊走子指定の為には親と異なることを指し示す｡ Specifies the mouse cursor to be used for the widget. The value may have any of the forms acceptable to Tk_GetCursor. In addition, if an empty string is specified, it indicates that the widget should defer to its parent for cursor specification.

Command-Line Name: -compound
Database Name: compound
Database Class: Compound
  部品が文書と点地図/影像を同時に表示すべきかを指定する､そして､肯定であれば､点地図/影像は文書の相対的にどちらに設置すべきかを指定する｡値は none か bottom か top か left か right か center かの内の一つでなければならない｡譬えば､(省略時設定の)値 none は点地図又は影像が(もし定義されていると)文書の代りに表示される､値 left は点地図又は影像が文書の左に表示されることを指定し､値 center は点地図又は影像が文書の頂に表示されることを指定する｡ 　　 Specifies if the widget should display text and bitmaps/images at the same time, and if so, where the bitmap/image should be placed relative to the text. Must be one of the values none, bottom, top, left, right, or center. For example, the (default) value none specifies that the bitmap or image should (if defined) be displayed instead of the text, the value left specifies that the bitmap or image should be displayed to the left of the text, and the value center specifies that the bitmap or image should be displayed on top of the text.

Command-Line Name: -disabledforeground
Database Name: disabledForeground
Database Class: DisabledForeground
  不能の部品を描く時に使う前景色を指定する｡もしこの指示項目が空文字列として指定されると(それは典型的には白黒表示上で起る)､不能の要素は通常の前景色を使って描かれるが､点で模様を満たす方法により薄く描かれる｡ Specifies foreground color to use when drawing a disabled element. If the option is specified as an empty string (which is typically the case on monochrome displays), disabled elements are drawn with the normal foreground color but they are dimmed by drawing them with a stippled fill pattern.

Command-Line Name: -exportselection
Database Name: exportSelection
Database Class: ExportSelection
  部品内の選択が同時に X 選択であるかを指定する｡その値は Tcl_GetBoolean に受入可能などのような形式でも有し得る､譬えば true や false や 0 や 1 や yes や no ｡もし選択が輸送される場合､部品内の選択は X 選択を非選択にする､部品の外の選択はどのような部品も非選択にする､又､部品はそれが選択された時は選択取戻しの為に反応する｡省略時設定は通常部品の為の選択を輸送する｡ Specifies whether or not a selection in the widget should also be the X selection. The value may have any of the forms accepted by Tcl_GetBoolean, such as true, false, 0, 1, yes, or no. If the selection is exported, then selecting in the widget deselects the current X selection, selecting outside the widget deselects any widget selection, and the widget will respond to selection retrieval requests when it has a selection. The default is usually for widgets to export selections.

Command-Line Name: -font
Database Name: font
Database Class: Font
  部品内部に文書を描く時に使う文字形状を指定する｡値は font の取扱説明書の頁の FONT DESCRIPTION の中の記述のどの形式の値を有してもよい｡ Specifies the font to use when drawing text inside the widget. The value may have any of the forms described in the font manual page under FONT DESCRIPTION.

Command-Line Name: -foreground or -fg
Database Name: foreground
Database Class: Foreground
  部品を表示する時に使う通常の前景色を指定する｡ 　　 Specifies the normal foreground color to use when displaying the widget.

Command-Line Name: -highlightbackground
Database Name: highlightBackground
Database Class: HighlightBackground
  部品が入力の注目を有していない時の横断的な強調領域を表示する時に使う色を指定する｡ Specifies the color to display in the traversal highlight region when the widget does not have the input focus.

Command-Line Name: -highlightcolor
Database Name: highlightColor
Database Class: HighlightColor
  部品が入力の注目を有している時にその回りに描かれる横断的な強調矩形に使う色を指定する｡ Specifies the color to use for the traversal highlight rectangle that is drawn around the widget when it has the input focus.

Command-Line Name: -highlightthickness
Database Name: highlightThickness
Database Class: HighlightThickness
  部品が入力の注目を有している時にその回りに描かれる横断的な強調矩形の幅を指し示す非負の値を指定する｡その値は Tk_GetPixels に受入可能などのような形式でも有し得る｡もし値が零の場合､部品の回りに注目を表す強調は描かれない｡ Specifies a non-negative value indicating the width of the highlight rectangle to draw around the outside of the widget when it has the input focus. The value may have any of the forms acceptable to Tk_GetPixels. If the value is zero, no focus highlight is drawn around the widget.

Command-Line Name: -image
Database Name: image
Database Class: Image
  部品内に表示する影像を指定する､それは image create 命令によって作成されたものでなければならない｡典型的にはもし､ -image 指示項目が指定されていると､それは部品内で表示する為に指定された点地図や文書値の他の指示項目を上書きする､これは -compound 指示項目によって制御されておこる; -image 指示項目は､点地図や文書を再度可能にするために空文字列に刷新され得る｡ Specifies an image to display in the widget, which must have been created with the image create command. Typically, if the -image option is specified then it overrides other options that specify a bitmap or textual value to display in the widget, though this is controlled by the -compound option; the -image option may be reset to an empty string to re-enable a bitmap or text display.

Command-Line Name: -insertbackground
Database Name: insertBackground
Database Class: Foreground
  挿入遊走子に覆われた領域内の背景に使う色を指定する｡この色は通常は部品の為の通常の背景色に上書きされる(又は遊走子がたまたま選択内にあると選択背景の色に)｡ Specifies the color to use as background in the area covered by the insertion cursor. This color will normally override either the normal background for the widget (or the selection background if the insertion cursor happens to fall in the selection).

Command-Line Name: -insertborderwidth
Database Name: insertBorderWidth
Database Class: BorderWidth
  挿入遊走子の回りに描かれた立体的縁の幅を指し示す非負の値を指定する｡その値は Tk_GetPixels に受入可能などのような形式でも有し得る｡ Specifies a non-negative value indicating the width of the 3-D border to draw around the insertion cursor. The value may have any of the forms acceptable to Tk_GetPixels.

Command-Line Name: -insertofftime
Database Name: insertOffTime
Database Class: OffTime
  挿入遊走子がそれぞれの明滅往復内で “断” に留まるべき千分の１秒単位の数を指し示す非負の整数値を指定する｡もしこの指示項目が零であると遊走子は明滅しない: 明になり続ける｡ Specifies a non-negative integer value indicating the number of milliseconds the insertion cursor should remain “off” in each blink cycle. If this option is zero then the cursor does not blink: it is on all the time.

Command-Line Name: -insertontime
Database Name: insertOnTime
Database Class: OnTime
  挿入遊走子がそれぞれの明滅往復内で “明” に留まるべき千分の１秒単位の数を指し示す非負の整数値を指定する｡ Specifies a non-negative integer value indicating the number of milliseconds the insertion cursor should remain “on” in each blink cycle.

Command-Line Name: -insertwidth
Database Name: insertWidth
Database Class: InsertWidth
  挿入遊走子を表示する総合幅となる非負値を指定する｡その値は Tk_GetPixels に受入可能などのような形式でも有し得る｡もし､( -insertborderwidth 指示項目を遣って)挿入遊走子の為に境界が指定されていると､境界は -insertwidth 指示項目に指定された巾の内部に描かれる｡ 　 Specifies a non-negative value indicating the total width of the insertion cursor. The value may have any of the forms acceptable to Tk_GetPixels. If a border has been specified for the insertion cursor (using the -insertborderwidth option), the border will be drawn inside the width specified by the -insertwidth option.

Command-Line Name: -jump
Database Name: jump
Database Class: Jump
  巻上げ帯の様な値を調整する為に引き摺られる摺動子付きの部品の為にこの指示項目は値の変化を知らせる時に定める｡その値は Tcl_GetBoolean に受入可能などのような形式でも有し得る｡もし値が偽値である場合､摺動子が引き摺られるに従い連続して更新がなされる｡もし値が真値である場合､引き摺りが終わりマウス釦が解除されるまで更新は延期される; その時点で一回の通知がされる(値は滑らかに変化ではなく “跳び付く” )｡ For widgets with a slider that can be dragged to adjust a value, such as scrollbars, this option determines when notifications are made about changes in the value. The option's value must be a boolean of the form accepted by Tcl_GetBoolean. If the value is false, updates are made continuously as the slider is dragged. If the value is true, updates are delayed until the mouse button is released to end the drag; at that point a single notification is made (the value “jumps” rather than changing smoothly).

Command-Line Name: -justify
Database Name: justify
Database Class: Justify
  部品内の表示文書に複数の行がある時､この指示項目は如何に行を整列するかを定める｡ left か center か right の内の一つでなければならない｡ left の意味は行の左端が全て揃う､ center の意味は行の中央が揃う､ right の意味は行の右端が揃う｡ When there are multiple lines of text displayed in a widget, this option determines how the lines line up with each other. Must be one of left, center, or right. Left means that the lines' left edges all line up, center means that the lines' centers are aligned, and right means that the lines' right edges line up.

Command-Line Name: -orient
Database Name: orient
Database Class: Orient
  譬えば巻上げ帯の様に､水平か垂直の方向に向けることが可能な部品について､この指示項目はどちらの方向を使うかを指定する｡ horizontal か vertical かそれらの内の一つの短縮形かでなければならない｡ For widgets that can lay themselves out with either a horizontal or vertical orientation, such as scrollbars, this option specifies which orientation should be used. Must be either horizontal or vertical or an abbreviation of one of these.

Command-Line Name: -padx
Database Name: padX
Database Class: Pad
  如何に多くの余分の空間が部品の X-方向に要求されているかを指し示す非負の値を設定する｡その値は Tcl_GetPixels に受入可能などのような形式でも有し得る｡如何に大きな窓が必要か計算した時､その部品は必要とされる量を幅に追加することになる(部品内部に表示される幅によって定められる様に); もし幾何管理譜がその要求を満足させることができると､部品は内側に表示する左 そして/又は 右の余分な内部空間に行き着く｡大部分の部品はこの指示項目を文書詰めの為に使う: もしそれが点地図か影像を表示する場合､それは通常詰込み指示項目を無視する｡ Specifies a non-negative value indicating how much extra space to request for the widget in the X-direction. The value may have any of the forms acceptable to Tk_GetPixels. When computing how large a window it needs, the widget will add this amount to the width it would normally need (as determined by the width of the things displayed in the widget); if the geometry manager can satisfy this request, the widget will end up with extra internal space to the left and/or right of what it displays inside. Most widgets only use this option for padding text: if they are displaying a bitmap or image, then they usually ignore padding options.

Command-Line Name: -pady
Database Name: padY
Database Class: Pad
  如何に多くの余分の空間が部品の Y-方向に要求されているかを指し示す非負の値を設定する｡その値は Tcl_GetPixels に受入可能などのような形式でも有し得る｡如何に大きな窓が必要か計算した時､その部品は必要とされる量を高さに追加することになる(部品内部に表示される高さによって定められる様に); もし幾何管理譜がその要求を満足させることができると､部品は内側に表示する上 そして/又は 下の余分な内部空間に行き着く｡大部分の部品はこの指示項目を文書詰めの為に使う: もしそれが点地図か影像を表示する場合､それは通常詰込み指示項目を無視する｡ Specifies a non-negative value indicating how much extra space to request for the widget in the Y-direction. The value may have any of the forms acceptable to Tk_GetPixels. When computing how large a window it needs, the widget will add this amount to the height it would normally need (as determined by the height of the things displayed in the widget); if the geometry manager can satisfy this request, the widget will end up with extra internal space above and/or below what it displays inside. Most widgets only use this option for padding text: if they are displaying a bitmap or image, then they usually ignore padding options.

Command-Line Name: -placeholder
Database Name: placeHolder
Database Class: PlaceHolder
  表示すべき救助文書を指定する､表示される文書がない場合､部品は空である｡placeholder 文書は -font と -justify 指示項目の値を使用して表示される｡ Specifies a help text string to display if no text is otherwise displayed, that is when the widget is empty. The placeholder text is displayed using the values of the -font and -justify options.

Command-Line Name: -placeholderforeground
Database Name: placeholderForeground
Database Class: PlaceholderForeground
  placeholder 文書が表示される時に使用される色を指定する｡ 無為設定の色はos固有である｡ Specifies the foreground color to use when the placeholder text is displayed. The default color is platform-specific.

Command-Line Name: -relief
Database Name: relief
Database Class: Relief
  部品の為に望ましい立体効果を指定する｡受入れられる値は raised か sunken か flat か ridge か solid か groove かである｡値は､部品の内部が如何にその外部に較べて現れるかを指し示す｡譬えば､ raised は部品の内部が部品の外側に比べ画面から突出するように現される｡(訳注 raised:隆起､flat:平坦､sunken:陥没､ridge:畝枠､solid:筋枠､groove:溝枠) Specifies the 3-D effect desired for the widget. Acceptable values are raised, sunken, flat, ridge, solid, and groove. The value indicates how the interior of the widget should appear relative to its exterior; for example, raised means the interior of the widget should appear to protrude from the screen, relative to the exterior of the widget.

Command-Line Name: -repeatdelay
Database Name: repeatDelay
Database Class: RepeatDelay
  釦又は鍵が自動繰返しを始める前に保たれるべき千分の一秒単位の数を指定する｡譬えば､摺動盤内の上向きと下向きの矢に使われている｡ Specifies the number of milliseconds a button or key must be held down before it begins to auto-repeat. Used, for example, on the up- and down-arrows in scrollbars.

Command-Line Name: -repeatinterval
Database Name: repeatInterval
Database Class: RepeatInterval
  repeatDelay と一緒に使われる: 一度自動繰返しが始まると､この指示項目が自動繰返しの間の千分の一秒単位の数を定める｡ Used in conjunction with -repeatdelay: once auto-repeat begins, this option determines the number of milliseconds between auto-repeats.

Command-Line Name: -selectbackground
Database Name: selectBackground
Database Class: Foreground
  選択された品目を表示する時に使う背景色を指定する｡ Specifies the background color to use when displaying selected items.

Command-Line Name: -selectborderwidth
Database Name: selectBorderWidth
Database Class: BorderWidth
  選択された品目の回りに描かれる立体的境界の幅を指し示す非負の値を指定する｡その値は Tk_GetPixels に受入可能などのような形式でも有し得る｡ Specifies a non-negative value indicating the width of the 3-D border to draw around selected items. The value may have any of the forms acceptable to Tk_GetPixels.

Command-Line Name: -selectforeground
Database Name: selectForeground
Database Class: Background
  選択された品目を表示する時に使う前景色を指定する｡ Specifies the foreground color to use when displaying selected items.

Command-Line Name: -setgrid
Database Name: setGrid
Database Class: SetGrid
  この部品がその頂上水準の窓の為の格子の寸法変更を制御するかを定める論理値を指定する｡この指示項目は典型的には文書部品内で使われる､そこでは､その部品内の情報が自然な寸法(文字の寸法)を有し､且つ､その単位の整数の値がその窓の情報として意味がある｡これら自然な窓の寸法は格子を形成する｡もし setGrid 指示項目が真値に設定され場合､部品は窓管理譜と通信し､使用者が対話的に部品を含んでいる頂上水準の窓を寸法変更すると窓の寸法は使用者の格子単位を表示し､窓の寸法は格子単位の整数値に拘束される｡更なる詳細は取扱説明書の wm 内の GRIDDED GEOMETRY MANAGEMENT の節を参照されたい｡ Specifies a boolean value that determines whether this widget controls the resizing grid for its top-level window. This option is typically used in text widgets, where the information in the widget has a natural size (the size of a character) and it makes sense for the window's dimensions to be integral numbers of these units. These natural window sizes form a grid. If the -setgrid option is set to true then the widget will communicate with the window manager so that when the user interactively resizes the top-level window that contains the widget, the dimensions of the window will be displayed to the user in grid units and the window size will be constrained to integral numbers of grid units. See the section GRIDDED GEOMETRY MANAGEMENT in the wm manual entry for more details.

Command-Line Name: -takefocus
Database Name: takeFocus
Database Class: TakeFocus
  鍵盤の横断の間に注目を窓が受取るかを定める(譬えば､Tab と Shift-Tab)｡窓に注目を設定する前には､横断の記述譜は takeFocus 指示項目の値を調べる｡値 0 は窓が鍵盤の横断の間に飛越されることを意味する｡ 1 は､窓が見える限りは入力の注目を受取る(それとその先祖は対応付けされる)｡指示項目に対する空の値は横断の記述譜に窓の上に注目するか否かを決めさせる: 現在の仕組みでは不能か､もし鍵盤の束縛を持たないか､又は見えないか､の場合は窓を飛越す｡もし値が他の形式を有する場合､横断の記述譜はその値をとり､窓の名前をそれに追記する(空白で区切って)､そしてその結果をTcl 記述譜として評価する｡記述譜は 0 か 1 か空文字列を返す筈である: 0 か 1 の値は窓が入力の注目を受取るか否かを指し示す､また､空文字列は､結果として上述の無為設定になる｡註意: この指示項目の解釈は全て Tcl 記述譜によって定義され､それは鍵盤の横断を実装する: 部品の実装は指示項目を全く無視する､そこで使用者は鍵盤の横断の記述譜を再定義してその意味を変更できる｡ Determines whether the window accepts the focus during keyboard traversal (e.g., Tab and Shift-Tab). Before setting the focus to a window, the traversal scripts consult the value of the -takefocus option. A value of 0 means that the window should be skipped entirely during keyboard traversal. 1 means that the window should receive the input focus as long as it is viewable (it and all of its ancestors are mapped). An empty value for the option means that the traversal scripts make the decision about whether or not to focus on the window: the current algorithm is to skip the window if it is disabled, if it has no key bindings, or if it is not viewable. If the value has any other form, then the traversal scripts take the value, append the name of the window to it (with a separator space), and evaluate the resulting string as a Tcl script. The script must return 0, 1, or an empty string: a 0 or 1 value specifies whether the window will receive the input focus, and an empty string results in the default decision described above. Note that this interpretation of the option is defined entirely by the Tcl scripts that implement traversal: the widget implementations ignore the option entirely, so you can change its meaning if you redefine the keyboard traversal scripts.

Command-Line Name: -text
Database Name: text
Database Class: Text
  部品内部に表示される文字列を指定する｡文字列が表示される方法は特定の部品に依存し､譬えば -anchor や -justify の様な他の指示項目にも依存するかもしれない｡ Specifies a string to be displayed inside the widget. The way in which the string is displayed depends on the particular widget and may be determined by other options, such as -anchor or -justify.

Command-Line Name: -textvariable
Database Name: textVariable
Database Class: Variable
  大域変数の名前を指定する｡その変数の値は部品の内部に表示される文書文字列であり; もし変数の値が変化すると部品が自動的に更新され新しい値が自身に反映される｡文字列が表示される方法は個別の部品に依存し､譬えば -anchor や -justify の様な他の指示項目にも依存するかもしれない｡ Specifies the name of a global variable. The value of the variable is a text string to be displayed inside the widget; if the variable value changes then the widget will automatically update itself to reflect the new value. The way in which the string is displayed in the widget depends on the particular widget and may be determined by other options, such as -anchor or -justify.

Command-Line Name: -troughcolor
Database Name: troughColor
Database Class: Background
  巻上げ帯や定規の様な部品内の矩形の窪みの領域に使用する色を指定する｡この指示項目は Windows の巻上げ帯では無視される(生来の部品がこの指示項目を認識しない)｡ Specifies the color to use for the rectangular trough areas in widgets such as scrollbars and scales. This option is ignored for scrollbars on Windows (native widget does not recognize this option).

Command-Line Name: -underline
Database Name: underline
Database Class: Underline
  部品内の下線を引く文字の整数索引を指定する｡この指示項目は指示項目聚釦と択肢聚の入り口の為の鍵盤の類別化の実装の為に無為設定の束縛に使用される｡ 0 は部品内の表示される文書の最初の文字に対応し､1 はその隣の文字に､以下続く｡ endは末尾の文字に､end-1は末尾の前の文字に､の順で相応する｡ Specifies the integer index of a character to underline in the widget. This option is used by the default bindings to implement keyboard traversal for menu buttons and menu entries. 0 corresponds to the first character of the text displayed in the widget, 1 to the next character, and so on. end corresponds to the last character, end-1 to the before last character, and so on.

Command-Line Name: -wraplength
Database Name: wrapLength
Database Class: WrapLength
  語の折り畳みができる部品の為に､この指示項目は最大行長を指定する｡この長さを超えた行は次の行に畳まれる､この長さを超える行はなくなる｡値は画面距離の為のどのような標準的な形式でもよい｡もし､値が零かそれより小さいと折り畳みは起らない: 行は改行文字が文書にあるときのみ折り畳まれるようになる｡ For widgets that can perform word-wrapping, this option specifies the maximum line length. Lines that would exceed this length are wrapped onto the next line, so that no line is longer than the specified length. The value may be specified in any of the standard forms for screen distances. If this value is negative or zero then no wrapping is done: lines will break only at newline characters in the text.

Command-Line Name: -xscrollcommand
Database Name: xScrollCommand
Database Class: ScrollCommand
  水平巻上げ帯との通信に使う命令の為の接頭辞を指定する｡部品の窓の視野が変わる時(又は､その他何時であれ､譬えば部品の内容の合計寸法が変化する様な巻上げ帯内の表示が変わり得る場合には何時でも)､部品は巻上げ命令と二つの数を鎖状に繋いで Tcl 命令を作る｡それぞれの数は 0 と 1 の間の小数で､文章内での位置を指し示し､ 0 は文章の初めを指し示し､ 1 は末尾を指し示し､ .333 は文章の全体の三分の一を指し示し､以下同様である｡第１の小数は､文章の､窓内に可視の初めの位置を指し示し､第２の小数は窓内に可視の最後の部位の直後の位置を指し示す｡この命令は､次に､実行の為に Tcl 解釈実行機能に渡される｡典型的には -xScrollCommand 指示項目は､巻上げ帯部品の経路名に “set” が続いて構成される､譬えば “.x.scrollbar set” の如し: これにより何時であれ窓内の視野が変わる時は何時でも巻上げ帯が更新されることになる｡もしこの指示項目が設定されない場合は命令は何も実行されることはない｡ Specifies the prefix for a command used to communicate with horizontal scrollbars. When the view in the widget's window changes (or whenever anything else occurs that could change the display in a scrollbar, such as a change in the total size of the widget's contents), the widget will generate a Tcl command by concatenating the scroll command and two numbers. Each of the numbers is a fraction between 0 and 1, which indicates a position in the document. 0 indicates the beginning of the document, 1 indicates the end, .333 indicates a position one third the way through the document, and so on. The first fraction indicates the first information in the document that is visible in the window, and the second fraction indicates the information just after the last portion that is visible. The command is then passed to the Tcl interpreter for execution. Typically the -xscrollcommand option consists of the path name of a scrollbar widget followed by “set”, e.g. “.x.scrollbar set”: this will cause the scrollbar to be updated whenever the view in the window changes. If this option is not specified, then no command will be executed.

Command-Line Name: -yscrollcommand
Database Name: yScrollCommand
Database Class: ScrollCommand
  垂直巻上げ帯による通信に使う命令の為の接頭辞を指定する｡この指示項目は -xScrollCommand 指示項目と同じ方法で取り扱う､違いはこれは垂直巻上げ帯に使われ､それは垂直巻上げを運営する｡この指示項目を如何に使用するかの詳細は -xScrollCommand の記述を参照されたい｡ Specifies the prefix for a command used to communicate with vertical scrollbars. This option is treated in the same way as the -xscrollcommand option, except that it is used for vertical scrollbars and is provided by widgets that support vertical scrolling. See the description of -xscrollcommand for details on how this option is used.

### SEE ALSO

colors, cursors, font

### KEYWORDS

class, name, standard option, switch
Copyright © 1990-1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.