## Tcl8.6.17/Tk8.6.17 Documentation > Tk Commands > canvas

### 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
    canvas — 表面部品を描画する '画布' 超越画像の生成と操作 Create and manipulate 'canvas' hypergraphics drawing surface widgets
  構文 SYNOPSIS
  STANDARD OPTIONS
    -background or -bg, background, Background
    -borderwidth or -bd, borderWidth, BorderWidth
    -cursor, cursor, Cursor
    -highlightbackground, highlightBackground, HighlightBackground
    -highlightcolor, highlightColor, HighlightColor
    -highlightthickness, highlightThickness, HighlightThickness
    -insertbackground, insertBackground, Foreground
    -insertborderwidth, insertBorderWidth, BorderWidth
    -insertofftime, insertOffTime, OffTime
    -insertontime, insertOnTime, OnTime
    -insertwidth, insertWidth, InsertWidth
    -relief, relief, Relief
    -selectbackground, selectBackground, Foreground
    -selectborderwidth, selectBorderWidth, BorderWidth
    -selectforeground, selectForeground, Background
    -takefocus, takeFocus, TakeFocus
    -xscrollcommand, xScrollCommand, ScrollCommand
    -yscrollcommand, yScrollCommand, ScrollCommand
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -closeenough, closeEnough, CloseEnough
    -confine, confine, Confine
    -height, height, Height
    -scrollregion, scrollRegion, ScrollRegion
    -state, state, State
    -width, width, width
    -xscrollincrement, xScrollIncrement, ScrollIncrement
    -yscrollincrement, yScrollIncrement, ScrollIncrement
  緒論 INTRODUCTION
  展示リスト DISPLAY LIST
  ITEM IDS AND TAGS
  COORDINATES
  転位 TRANSFORMATIONS
  INDICES
    number
    end
    insert
    sel.first
    sel.last
    @x,y
  DASH PATTERNS
  部品命令 WIDGET COMMAND
    pathName addtag tag searchSpec ?arg arg ...?
      above tagOrId
      all
      below tagOrId
      closest x y ?halo? ?start?
      enclosed x1 y1 x2 y2
      overlapping x1 y1 x2 y2
      withtag tagOrId
    pathName bbox tagOrId ?tagOrId tagOrId ...?
    pathName bind tagOrId ?sequence? ?command?
    pathName canvasx screenx ?gridspacing?
    pathName canvasy screeny ?gridspacing?
    pathName cget option
    pathName configure ?option? ?value? ?option value ...?
    pathName coords tagOrId ?x0 y0 ...?
    pathName coords tagOrId ?coordList?
    pathName create type x y ?x y ...? ?option value ...?
    pathName create type coordList ?option value ...?
    pathName dchars tagOrId first ?last?
    pathName delete ?tagOrId tagOrId ...?
    pathName dtag tagOrId ?tagToDelete?
    pathName find searchCommand ?arg arg ...?
    pathName focus ?tagOrId?
    pathName gettags tagOrId
    pathName icursor tagOrId index
    pathName imove tagOrId index x y
    pathName index tagOrId index
    pathName insert tagOrId beforeThis string
    pathName itemcget tagOrId option
    pathName itemconfigure tagOrId ?option? ?value? ?option value ...?
    pathName lower tagOrId ?belowThis?
    pathName move tagOrId xAmount yAmount
    pathName moveto tagOrId xPos yPos
    pathName postscript ?option value option value ...?
      -channel channelName
      -colormap varName
      -colormode mode
      -file fileName
      -fontmap varName
      -height size
      -pageanchor anchor
      -pageheight size
      -pagewidth size
      -pagex position
      -pagey position
      -rotate boolean
      -width size
      -x position
      -y position
    pathName raise tagOrId ?aboveThis?
    pathName rchars tagOrId first last string
    pathName scale tagOrId xOrigin yOrigin xScale yScale
    pathName scan option args
      pathName scan mark x y
      pathName scan dragto x y ?gain?
    pathName select option ?tagOrId arg?
      pathName select adjust tagOrId index
      pathName select clear
      pathName select from tagOrId index
      pathName select item
      pathName select to tagOrId index
    pathName type tagOrId
    pathName xview ?args?
      pathName xview
      pathName xview moveto fraction
      pathName xview scroll number what
    pathName yview ?args?
      pathName yview
      pathName yview moveto fraction
      pathName yview scroll number what
  品目の型の概論 OVERVIEW OF ITEM TYPES
  共通の品目の指示項目 COMMON ITEM OPTIONS
    -anchor anchorPos
    -dash pattern
    -activedash pattern
    -disableddash pattern
    -dashoffset offset
    -fill color
    -activefill color
    -disabledfill color
    -outline color
    -activeoutline color
    -disabledoutline color
    -offset offset
    -outlinestipple bitmap
    -activeoutlinestipple bitmap
    -disabledoutlinestipple bitmap
    -outlineoffset offset
    -stipple bitmap
    -activestipple bitmap
    -disabledstipple bitmap
    -state state
    -tags tagList
    -width outlineWidth
    -activewidth outlineWidth
    -disabledwidth outlineWidth
  標準品目の型 STANDARD ITEM TYPES
  円弧品目 ARC ITEMS
    -extent degrees
    -start degrees
    -style type
  点地図品目 BITMAP ITEMS
    -background color
    -activebackground color
    -disabledbackground color
    -bitmap bitmap
    -activebitmap bitmap
    -disabledbitmap bitmap
    -foreground color
    -activeforeground color
    -disabledforeground color
  影像品目 IMAGE ITEMS
    -image name
    -activeimage name
    -disabledimage name
  線品目 LINE ITEMS
    -arrow where
    -arrowshape shape
    -capstyle style
    -joinstyle style
    -smooth smoothMethod
    -splinesteps number
  楕円品目 OVAL ITEMS
  多角形品目 POLYGON ITEMS
    -joinstyle style
    -smooth boolean
    -splinesteps number
  矩形品目 RECTANGLE ITEMS
  文書品目 TEXT ITEMS
    -angle rotationDegrees
    -font fontName
    -justify how
    -text string
    -underline
    -width lineLength
  窓の品目 WINDOW ITEMS
    -height pixels
    -width pixels
    -window pathName
  応用譜定義の品目の型 APPLICATION-DEFINED ITEM TYPES
  束縛 BINDINGS
  著作権表示 CREDITS
  SEE ALSO
  KEYWORDS

### NAME

canvas — 表面部品を描画する '画布' 超越画像の生成と操作 Create and manipulate 'canvas' hypergraphics drawing surface widgets

### 構文 SYNOPSIS

canvas pathName ?options?

### STANDARD OPTIONS

-background or -bg, background, Background
-borderwidth or -bd, borderWidth, BorderWidth
-cursor, cursor, Cursor
-highlightbackground, highlightBackground, HighlightBackground
-highlightcolor, highlightColor, HighlightColor
-highlightthickness, highlightThickness, HighlightThickness
-insertbackground, insertBackground, Foreground
-insertborderwidth, insertBorderWidth, BorderWidth
-insertofftime, insertOffTime, OffTime
-insertontime, insertOnTime, OnTime
-insertwidth, insertWidth, InsertWidth
-relief, relief, Relief
-selectbackground, selectBackground, Foreground
-selectborderwidth, selectBorderWidth, BorderWidth
-selectforeground, selectForeground, Background
-takefocus, takeFocus, TakeFocus
-xscrollcommand, xScrollCommand, ScrollCommand
-yscrollcommand, yScrollCommand, ScrollCommand

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

Command-Line Name: -closeenough
Database Name: closeEnough
Database Class: CloseEnough
  マウスの遊走子が品目の “内部” に入っていると看做される迄にどれ程品目の近くに寄る必要があるのかを浮動小数の値で指し示す｡省略時設定は 1.0 ｡　　　　 Specifies a floating-point value indicating how close the mouse cursor must be to an item before it is considered to be “inside” the item. Defaults to 1.0.

Command-Line Name: -confine
Database Name: confine
Database Class: Confine
  scrollRegion 引数によって定義される領域の外にある画布の視野を設定することを許容するか否かを指し示す論理値を指定する｡省略時設定は真値であり､その意味は､視野は摺動領域内に強制される｡　　　　 Specifies a boolean value that indicates whether or not it should be allowable to set the canvas's view outside the region defined by the scrollRegion argument. Defaults to true, which means that the view will be constrained within the scroll region.

Command-Line Name: -height
Database Name: height
Database Class: Height
  画布部品が画像管理譜から要求すべき望ましい窓の高さを指定する｡値は､下の COORDINATES 節内で記述するどの形式で指定してもよい｡　　　　 Specifies a desired window height that the canvas widget should request from its geometry manager. The value may be specified in any of the forms described in the COORDINATES section below.

Command-Line Name: -scrollregion
Database Name: scrollRegion
Database Class: ScrollRegion
  矩形の領域の左､上､右､下の座標を記述する四つの座標のリストを指定する｡この領域は､摺動する目的に使われ､又､画布中の情報の束縛になると看做される｡それぞれの座標は下の COORDINATES 節内で与えられるどの形式で指定されてもよい｡　　　　 Specifies a list with four coordinates describing the left, top, right, and bottom coordinates of a rectangular region. This region is used for scrolling purposes and is considered to be the boundary of the information in the canvas. Each of the coordinates may be specified in any of the forms given in the COORDINATES section below.

Command-Line Name: -state
Database Name: state
Database Class: State
  画布の省略時設定の状態を修正する､ここで状態は次の内の一つ: normal か disabled か hidden ｡個別の画布対象は全て自己の状態指示項目を有しており､それは省略時設定の状態を上書きし得る｡多くの指示項目が､恰も異なる状況内で品目の外観が異り得る如く別々の規格を採り得る｡active 状態で始まる指示項目はマウスの指示子がその上にある時外観を制御する､無能で始まる指示項目は無能の状態の時の外観を制御する｡無能である画布品目は画布の束縛に反応しない｡　　　　 Modifies the default state of the canvas where state may be set to one of: normal, disabled, or hidden. Individual canvas objects all have their own state option which may override the default state. Many options can take separate specifications such that the appearance of the item can be different in different situations. The options that start with active control the appearance when the mouse pointer is over it, while the option starting with disabled controls the appearance when the state is disabled. Canvas items which are disabled will not react to canvas bindings.

Command-Line Name: -width
Database Name: width
Database Class: width
  画布部品が画像管理譜から要求すべき望ましい窓の幅を指定する｡値は､下の COORDINATES 節内で記述されるどの形式で指定されてもよい｡　　　　 Specifies a desired window width that the canvas widget should request from its geometry manager. The value may be specified in any of the forms described in the COORDINATES section below.

Command-Line Name: -xscrollincrement
Database Name: xScrollIncrement
Database Class: ScrollIncrement
  水平摺動増量を指定する､画面の距離の為に許容される通常のどの形式の単位でもよい｡もし､この指示項目の値が零より大きいと窓の水平の視野は､窓の左端に於ける画布の x 座標が常に xScrollIncrement の偶数倍である様に強制され; 更に､摺動の単位(譬えば､摺動盤の右か左の矢印が選択された時の視野の変化)も xScrollIncrement になる｡もし､この指示項目の値が零かそれより小さいと､水平摺動は拘束されない｡　　　　 Specifies an increment for horizontal scrolling, in any of the usual forms permitted for screen distances. If the value of this option is greater than zero, the horizontal view in the window will be constrained so that the canvas x coordinate at the left edge of the window is always an even multiple of xScrollIncrement; furthermore, the units for scrolling (e.g., the change in view when the left and right arrows of a scrollbar are selected) will also be xScrollIncrement. If the value of this option is less than or equal to zero, then horizontal scrolling is unconstrained.

Command-Line Name: -yscrollincrement
Database Name: yScrollIncrement
Database Class: ScrollIncrement
  垂直摺動増量を指定する､画面の距離の為に許容される通常のどの形式の単位でもよい｡もし､この指示項目の値が零より大きいと窓の垂直の視野は､窓の上端に於ける画布の y 座標が常に yScrollIncrement の偶数倍である様に強制され; 更に､摺動の単位(譬えば､摺動盤の上か下の矢印が選択された時の視野の変化)も yScrollIncrement になる｡もし､この指示項目の値が零かそれより小さいと､垂直摺動は拘束されない｡　　　　 Specifies an increment for vertical scrolling, in any of the usual forms permitted for screen distances. If the value of this option is greater than zero, the vertical view in the window will be constrained so that the canvas y coordinate at the top edge of the window is always an even multiple of yScrollIncrement; furthermore, the units for scrolling (e.g., the change in view when the top and bottom arrows of a scrollbar are selected) will also be yScrollIncrement. If the value of this option is less than or equal to zero, then vertical scrolling is unconstrained.

### 緒論 INTRODUCTION

この canvas 命令は(pathName 引数で与えられる)新しい窓を生成しそれを画布部品にする｡上に述べた追加的な指示項目は命令行又は､その色や３次元立体感の様な画布の外観を構成設定する為の追加的な基礎データの中で指定されてもよい｡canvas 命令はその pathName 引数を返す｡この命令が起動される時､ pathName と謂う名前の窓が存在してはならないが､ pathName の親は実在しなければならない｡　　　　 The canvas command creates a new window (given by the pathName argument) and makes it into a canvas widget. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the canvas such as its colors and 3-D relief. The canvas 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.

画布部品は構造的画像を実現する｡画布は何個でも品目を表示し､それらは､矩形､丸､線､文書のようなものである｡品目は操作もでき(譬えば､移動や変色)､又 bind 命令が命令を部品に束縛することを許容するのとほぼ同じ方法で命令が品目に結合される｡譬えば､特定の命令が <Button-1> 行事に結合され得て､何時であれ､その品目上に遊走子がある時に釦 1 が押されるとその命令が起動される｡この意味は､画布中の品目は､それに束縛された Tcl 記述譜により振舞いを定義させ得ることを意味する｡　　　　 Canvas widgets implement structured graphics. A canvas displays any number of items, which may be things like rectangles, circles, lines, and text. Items may be manipulated (e.g. moved or re-colored) and commands may be associated with items in much the same way that the bind command allows commands to be bound to widgets. For example, a particular command may be associated with the <Button-1> event so that the command is invoked whenever button 1 is pressed with the mouse cursor over an item. This means that items in a canvas can have behaviors defined by the Tcl scripts bound to them.

### 展示リスト DISPLAY LIST

画布内の品目は展示の為に並べられ､展示リストの第１番目の品目が第１番目に展示され､続いてリスト中の次の品目が続き､以下が続く｡展示リストの遅い品目は展示リストの早いものを覆い隠し､時には､早い品目の “上にある” として参照される｡新しい品目が作成される時､展示リストの末尾に置かれ､その他の全ての上になる｡部品命令は展示リストの順番の並び替えをする為にも利用できる｡　　　　 The items in a canvas are ordered for purposes of display, with the first item in the display list being displayed first, followed by the next item in the list, and so on. Items later in the display list obscure those that are earlier in the display list and are sometimes referred to as being “on top” of earlier items. When a new item is created it is placed at the end of the display list, on top of everything else. Widget commands may be used to re-arrange the order of the display list.

窓品目は上述の規則の例外である｡基礎になる窓系は常に他の品目の頂に描かれることを要す｡更に､窓品目の重なりの順序はどの画布命令によっても影響を受けない､それには代りに Tk raise 命令か lower 命令を使う必要がある｡　　　　 Window items are an exception to the above rules. The underlying window systems require them always to be drawn on top of other items. In addition, the stacking order of window items is not affected by any of the canvas widget commands; you must use the Tk raise command and lower command instead.

### ITEM IDS AND TAGS

画布部品中の品目は二つの方法で名前を付けられる: 識別番号か貼り札｡それぞれの品目は固有の識別用の番号を有し､その品目が作成される時に代入される｡この品目の識別番号は変化することなく､又､画布部品の寿命の間に､再採番されることもない｡　　　　 Items in a canvas widget may be named in either of two ways: by id or by tag. Each item has a unique identifying number, which is assigned to that item when it is created. The id of an item never changes and id numbers are never re-used within the lifetime of a canvas widget.

それぞれの品目はそれに結合した幾つもの貼り札を有してもよく､貼り札は､単なる文字列であって､整数以外のどの様な形式でもよい｡譬えば “x123” は可であるが “123” は不可である｡多くの異なる品目に同じ貼り札が結合されることがある｡これは普通には､種々の興味ある方法による､品目の群別でなされる; 譬えば､選び出した全部の品目に “厳選品” の貼り札を与えてもよい｡　　　　 Each item may also have any number of tags associated with it. A tag is just a string of characters, and it may take any form except that of an integer. For example, “x123” is OK but “123” is not. The same tag may be associated with many different items. This is commonly done to group items in various interesting ways; for example, all selected items might be given the tag “selected”.

貼り札 all は画布内の全ての品目に暗黙裡に結合される; それは画布内の全ての品目上の操作を起動することに使える｡　　　　 The tag all is implicitly associated with every item in the canvas; it may be used to invoke operations on all the items in the canvas.

貼り札 current は自動的に Tk により管理される; それは current item に適用され､それは最も上にある品目であり､その描画領域はマウス遊走子の位置を含む(異なる品目の型は種々な方法でこれを解釈する; 詳細については個別の品目の型の説明書を参照されたい)｡もし､マウスが画布部品内にないか､その品目の上にない場合､どの品目も current 貼り札を有していない｡　　　　 The tag current is managed automatically by Tk; it applies to the current item, which is the topmost item whose drawn area covers the position of the mouse cursor (different item types interpret this in varying ways; see the individual item type documentation for details). If the mouse is not in the canvas widget or is not over an item, then no item has the current tag.

画布部品命令内で品目を指定するとき､もし指定子が整数であると､それはその識別番号の一個の品目を参照すると仮定される｡もし､指定子が整数でない場合､その指示子に合致する貼り札を有する画布内の全ての品目を参照すると仮定される｡象徴記号 tagOrId は､一つの品目を選択する識別番号､若しくは､零かそれ以上の品目を選択する貼り札､のいずれかを指定する引数を指し示すことに下で使用される｡　　　　 When specifying items in canvas widget commands, if the specifier is an integer then it is assumed to refer to the single item with that id. If the specifier is not an integer, then it is assumed to refer to all of the items in the canvas that have a tag matching the specifier. The symbol tagOrId is used below to indicate that an argument specifies either an id that selects a single item or a tag that selects zero or more items.

tagOrId は､演算子: “&&” と “||” と “^” と “!” と括弧で括った式の項とを使用した貼り札の論理式を含むこともできる｡ 譬えば: tagOrId may contain a logical expressions of tags by using operators: “&&”, “||”, “^”, “!”, and parenthesized subexpressions. For example:

    .c find withtag {(a&&!b)||(!a&&b)}

又は､等価的に:　　　　 or equivalently:

    .c find withtag {a^b}

これらは､ “a” か “b” の貼札の両方ではなく､いずれか片方を付けた品目だけを見付け出す｡　　　　 will find only those items with either “a” or “b” tags, but not both.

幾つかの部品命令は､ある時点では一つの品目のみを操作する; もし､多数の品目を指名する方法で､tagOrId が指定されると､この命令に関する通常の振舞いは､展示リスト内のこの命令に適している最初の(最低の)品目を使うことである｡例外は､下の部品命令内の記述に註意書きされている｡　　　　 Some widget commands only operate on a single item at a time; if tagOrId is specified in a way that names multiple items, then the normal behavior is for the command to use the first (lowest) of these items in the display list that is suitable for the command. Exceptions are noted in the widget command descriptions below.

### COORDINATES

画布に関する全ての座標は浮動小数点数として保存される｡座標と距離は､画面単位で､浮動小数に時として一つの文字を添えて指定される｡もし､文字が添えられないと､距離は画素単位である｡添える文字が m なら距離は画面上の粍単位である; 文字が c なら距離は画面上の糎単位である; i は吋を意味し; p は印刷ポイント(1/172吋)を意味する｡ 大きい値の y-座標は画面の下の方を参照し;大きい x-座標は画面の更に右の方を参照する｡座標は偶数個の假引数として､又は偶数の x と y の座標を含むリスト假引数として指定できる｡　　　　 All coordinates related to canvases are stored as floating-point numbers. Coordinates and distances are specified in screen units, which are floating-point numbers optionally followed by one of several letters. If no letter is supplied then the distance is in pixels. If the letter is m then the distance is in millimeters on the screen; if it is c then the distance is in centimeters; i means inches, and p means printers points (1/72 inch). Larger y-coordinates refer to points lower on the screen; larger x-coordinates refer to points farther to the right. Coordinates can be specified either as an even number of parameters, or as a single list parameter containing an even number of x and y coordinate values.

#### 転位 TRANSFORMATIONS

通常､画布の座標系の原点は画布を含む窓の左上隅にある｡画面の原点に相対的な画布の座標系の原点を xview と yview 部品命令を使って調整することは可能である; これは典型的には摺動に使用される｡画布は､画面の座標系に相対的な画布の座標系の拡大や回転を運用していない｡　　　　 Normally the origin of the canvas coordinate system is at the upper-left corner of the window containing the canvas. It is possible to adjust the origin of the canvas coordinate system relative to the origin of the window using the xview and yview widget commands; this is typically used for scrolling. Canvases do not support scaling or rotation of the canvas coordinate system relative to the window coordinate system.

個別の品目は下に述べる部品命令を使って移動や拡大されるが回転はされない｡　　　　 Individual items may be moved or scaled using widget commands described below, but they may not be rotated.

注意すべきは省略時設定の画布の可視領域の原点は､全体の窓の原点と一致するので､マウスの位置を使って束縛することを容易にしている; 使用者は､可視領域の原点を調整する場合に､canvasx と canvasy 命令を使う必要があるだけである｡しかし､これは又､画布の可視領域を得る前に､どの注目環( -highlightthickness 指示項目により制御される様な)も窓縁( -borderwidth 指示項目により制御される様な)も､考慮しておくべきであることを意味する｡　　　　 Note that the default origin of the canvas's visible area is coincident with the origin for the whole window as that makes bindings using the mouse position easier to work with; you only need to use the canvasx and canvasy widget commands if you adjust the origin of the visible area. However, this also means that any focus ring (as controlled by the -highlightthickness option) and window border (as controlled by the -borderwidth option) must be taken into account before you get to the visible area of the canvas.

### INDICES

文書品目は品目内の特定の場所を識別する為に索引 の概念を運用する｡線と多角形品目は､その座標の部分集合の識別､挿入､削除に関して索引 を､同じような方式で運用している｡索引は文字や座標の範囲の挿入や削除､又は､遊走子の位置の設定や挿入のような命令に関して使用される｡索引は幾つものどのような方法によって指定されてもよく､又､異なる型の品目は索引の指定について異なる形式を運用してもよい｡文書品目は索引について次の形式を運用している; 新しく文書-方式の品目を定義する場合は､実使用されているものと同じような多数の形式を運用することを薦める｡註意すべきは､文書品目内の最後の文字の直後を参照することが可能であることである; この品目の末尾に新しい文書を挿入する業務には､これが必須である｡線や多角形は挿入遊走子と選択は運用されてない｡その索引は常に偶数個であると假定されている､理由は座標は常に対で表されるから｡　　　　 Text items support the notion of an index for identifying particular positions within the item. In a similar fashion, line and polygon items support index for identifying, inserting and deleting subsets of their coordinates. Indices are used for commands such as inserting or deleting a range of characters or coordinates, and setting the insertion cursor position. An index may be specified in any of a number of ways, and different types of items may support different forms for specifying indices. Text items support the following forms for an index; if you define new types of text-like items, it would be advisable to support as many of these forms as practical. Note that it is possible to refer to the character just after the last one in the text item; this is necessary for such tasks as inserting new text at the end of the item. Lines and Polygons do not support the insertion cursor and the selection. Their indices are supposed to be even always, because coordinates always appear in pairs.

number
  文書品目内の望ましい文字の位置を与える十進数である｡ 0 は最初の文字を参照し､1 は次の文字を参照し､以下同様である｡もし線と多角形について､番号が奇数であると､自動的に1 つ減じられる｡零より小さい数は恰も零として扱われ､文書品目の長さより大きい数は恰も文書品目の長さと等しいかの如く扱われる｡多角形については､零より小さい又は座標リストの長さより大きい数は､結果が零と長さとの間に入るか等しくなる迄長さを加えたり引いたりして調節される｡　　　　 A decimal number giving the position of the desired character within the text item. 0 refers to the first character, 1 to the next character, and so on. If indexes are odd for lines and polygons, they will be automatically decremented by one. A number less than 0 is treated as if it were zero, and a number greater than the length of the text item is treated as if it were equal to the length of the text item. For polygons, numbers less than 0 or greater than the length of the coordinate list will be adjusted by adding or subtracting the length until the result is between zero and the length, inclusive.

end
  品目内の､文字又は座標の最後のもののすぐ後を参照する(品目内の文字又は座標の個数と同じ)｡　　　　 Refers to the character or coordinate just after the last one in the item (same as the number of characters or coordinates in the item).

insert
  挿入遊走子がその品目内に書込む位置の直前の文字を参照する｡線と多角形に対しては不適である｡　　　　 Refers to the character just before which the insertion cursor is drawn in this item. Not valid for lines and polygons.

sel.first
  品目中の選択の最初の文字を参照する｡もし選択がこの品目にない時はこの形式は不適である｡　　　　 Refers to the first selected character in the item. If the selection is not in this item then this form is illegal.

sel.last
  品目中の選択の最後の文字を参照する｡もし選択がこの品目にない時はこの形式は不適である｡　　　　 Refers to the last selected character in the item. If the selection is not in this item then this form is illegal.

@x,y
  x と y で与えられる位置の文字又は座標を参照する､ここで｡ x と y は画布内の座標系で指定される｡もし x と y が文書品目により覆われる範囲外にあると､与えられた位置に近い最初か最後の文字を参照する｡　　　　 Refers to the character or coordinate at the point given by x and y, where x and y are specified in the coordinate system of the canvas. If x and y lie outside the coordinates covered by the text item, then they refer to the first or last character in the line that is closest to the given point.

### DASH PATTERNS

多くの品目が輪郭について破線模様の概念を運用している｡ Many items support the notion of a dash pattern for outlines.

第１の可能な構文は整数のリストである｡それぞれの要素は線分の画素の数を表現する｡奇数番目の線分だけが “輪郭” 色を使って描かれる｡他の線分は透明に描かれる｡　　　　 The first possible syntax is a list of integers. Each element represents the number of pixels of a line segment. Only the odd segments are drawn using the “outline” color. The other segments are drawn transparent.

第二の可能な構文は５つだけの可能な文字 “.,-_ ” を含む文字リストである｡空白は他の線要素の間の空間を拡げるために使用でき､文字列の最初の位置にはならない｡幾つかの例は:　　　　 The second possible syntax is a character list containing only 5 possible characters “.,-_ ”. The space can be used to enlarge the space between other line elements, and cannot occur as the first position in the string. Some examples:

    -dash .     → -dash {2 4}
    -dash -     → -dash {6 4}
    -dash -.    → -dash {6 4 2 4}
    -dash -..   → -dash {6 4 2 4 2 4}
    -dash {. }  → -dash {2 8}
    -dash ,     → -dash {4 4}

最初のものとこの構文の主な違いは､形の-保守性である｡この意味は､破線リストは展示される前に線幅によって増大させられる｡それは､ “.” は常に点として展示され､ “-” は常に線幅を考慮せずに横線ととして展示されことを確信する｡　　　　 The main difference of this syntax with the previous is that it is shape-conserving. This means that all values in the dash list will be multiplied by the line width before display. This assures that “.” will always be displayed as a dot and “-” always as a dash regardless of the line width.

限定された破線模様の組を運用している体系上で､破線模様は利用できる破線模様に最も近いものが展示される｡譬えば､ Windows では上述の例の最初の４例が利用できる｡最後の２例は最初のものと同じに展示される｡　　　　 On systems which support only a limited set of dash patterns, the dash pattern will be displayed as the closest dash pattern that is available. For example, on Windows only the first 4 of the above examples are available. The last 2 examples will be displayed identically to the first one.

### 部品命令 WIDGET COMMAND

canvas 命令は名前が pathName の新しい Tcl 命令を作る｡この命令は部品上の種々の操作の起動に使用できる｡次の一般形式を有する:　　　　 The canvas 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 arg ...?

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

pathName addtag tag searchSpec ?arg arg ...?
  searchSpec と arg によって指定される条件に適合するそれぞれの品目について､ その品目に結合した貼り札リスト上に未だそれが存在しないと､貼り札リストにtag を追加する｡どの品目も searchSpec と arg によって与えられる条件を満足しないこともあり得る､その場合､この命令は効果がない｡この命令は結果として空文字列を返す｡ searchSpec と arg は次のどれかの形式をとる:　　　　 For each item that meets the constraints specified by searchSpec and the args, add tag to the list of tags associated with the item if it is not already present on that list. It is possible that no items will satisfy the constraints given by searchSpec and args, in which case the command has no effect. This command returns an empty string as result. SearchSpec and arg's may take any of the following forms:

  above tagOrId
    展示リスト内の tagOrId によって与えられるものの直ぐ後の(上になる)品目を選択する｡もし､tagOrId が二つ以上の品目を示す場合､展示リストの中の該当する最後の(最も頂の)品目が使われる｡ Selects the item just after (above) the one given by tagOrId in the display list. If tagOrId denotes more than one item, then the last (topmost) of these items in the display list is used.

  all
    画布内の全ての品目を選択する｡　　　　 Selects all the items in the canvas.

  below tagOrId
    展示リスト内の tagOrId によって与えられるものの直ぐ前の(下になる)品目を選択する｡もし､tagOrId が二つ以上の品目を示す場合､展示リストの中の該当する最初の(最も底の)品目が使われる｡　　　　 Selects the item just before (below) the one given by tagOrId in the display list. If tagOrId denotes more than one item, then the first (lowest) of these items in the display list is used.

  closest x y ?halo? ?start?
    x と y によって与えられる点に最も近い品目が選択される｡もし二つ以上の品目が同時に最も近い同じ距離にあると(譬えば､二つの品目が点に重複する)､最も上の品目(展示リストの最後のもの)が使用される｡もし halo が指定される場合､それは非負の値でなくてはならない｡その点に halo より近いどの品目もそれに重複すると看做される｡[譯註：halo=光輪､光背] start 引数は全ての最近接の品目を廻って巡回することに使われるかもしれない｡もし start が指定される場合､それは､品目に貼り札か識別番号を使って名前付けする(貼り札の場合は､与えられた貼り札による展示リスト内の最初の品目を選択する)｡最も上の最も近い品目を選択する代りに､この形式は展示リスト内の start の下側の最も上の最も近い品目を選択する; このような品目が存在しないと､選択は恰も start 引数が指定されなかったの如く振舞う｡　　　　 Selects the item closest to the point given by x and y. If more than one item is at the same closest distance (e.g. two items overlap the point), then the top-most of these items (the last one in the display list) is used. If halo is specified, then it must be a non-negative value. Any item closer than halo to the point is considered to overlap it. The start argument may be used to step circularly through all the closest items. If start is specified, it names an item using a tag or id (if by tag, it selects the first item in the display list with the given tag). Instead of selecting the topmost closest item, this form will select the topmost closest item that is below start in the display list; if no such item exists, then the selection behaves as if the start argument had not been specified.

  enclosed x1 y1 x2 y2
    x1 と y1 と x2 と y2 とによって与えられる矩形の領域に完全に囲まれる全ての品目を選択する｡ x1 は x2 よりも大きくてはならない､ y1 は y2 よりも大きくてはならない｡　　　　 Selects all the items completely enclosed within the rectangular region given by x1, y1, x2, and y2. X1 must be no greater than x2 and y1 must be no greater than y2.

  overlapping x1 y1 x2 y2
    x1 と y1 と x2 と y2 とによって与えられる矩形の領域に重なるか囲まれる全ての品目を選択する｡ x1 は x2 よりも大きくてはならない､ y1 は y2 よりも大きくてはならない｡　　　　 Selects all the items that overlap or are enclosed within the rectangular region given by x1, y1, x2, and y2. X1 must be no greater than x2 and y1 must be no greater than y2.

  withtag tagOrId
    tagOrId によって与えられる全ての品目を選択する｡　　　　 Selects all the items given by tagOrId.

pathName bbox tagOrId ?tagOrId tagOrId ...?
  tagOrId 引数によって指名される全ての品目に関する近似的な囲み箱を与える四つの要素のリストを返す｡そのリストは “x1 y1 x2 y2” の形式を有し､左が x1 ､右が x2 ､上が y1 ､下が y2 の囲み箱の領域内に､全ての指名した要素を描いた区域が入る｡返り値は実際の囲み箱より幾つかの画素分だけ過剰に見積もった値かもしれない｡どの tagOrId 引数にも合致する品目がないか合致する品目が空の囲み箱を有する(即ち､展示するものがない)場合は空文字列が返される｡　　　　 Returns a list with four elements giving an approximate bounding box for all the items named by the tagOrId arguments. The list has the form “x1 y1 x2 y2” such that the drawn areas of all the named elements are within the region bounded by x1 on the left, x2 on the right, y1 on the top, and y2 on the bottom. The return value may overestimate the actual bounding box by a few pixels. If no items match any of the tagOrId arguments or if the matching items have empty bounding boxes (i.e. they have nothing to display) then an empty string is returned.

pathName bind tagOrId ?sequence? ?command?
  この命令は､命令 command を tagOrId で与えれる品目に結合し､何時であれ品目の一つに sequence によって与えらえる行事並びが生じると､その命令が起動される様にする｡この部品命令は bind 命令に似ているが､部品全体ではなく画布内の品目を操作することが､異なっている｡ sequence の構文の詳細と起動する前に命令上で遂行される置換の完全なる詳細については取扱説明書のbind 見出しを参照されたい｡もし全ての引数が指定されると新しい束縛が生成され､どれでも既存の同じ sequence と tagOrId に関わる束縛を置き換える(もし命令の最初の文字が “+” であると､命令引数は置き換えでなく､既存のものに結合する)｡この場合､返り値は空文字列である｡もし命令が省略されるとこの命令は tagOrId と sequence に結合した命令を返す(このような束縛が存在しないと不都合が生じる)｡もし､ command と sequence の両方が省略されると､ tagOrId について定義された束縛のための全ての並びのリストを返す｡　　　　 This command associates command with all the items given by tagOrId such that whenever the event sequence given by sequence occurs for one of the items the command will be invoked. This widget command is similar to the bind command except that it operates on items in a canvas rather than entire widgets. See the bind manual entry for complete details on the syntax of sequence and the substitutions performed on command before invoking it. If all arguments are specified then a new binding is created, replacing any existing binding for the same sequence and tagOrId (if the first character of command is “+” then command augments an existing binding rather than replacing it). In this case the return value is an empty string. If command is omitted then the command returns the command associated with tagOrId and sequence (an error occurs if there is no such binding). If both command and sequence are omitted then the command returns a list of all the sequences for which bindings have been defined for tagOrId.

  束縛が指定されているかもしれない唯一の行事は( Enter や Leave や ButtonPress や Motion や KeyPress の如く)マウスか鍵盤に関連しているか､仮想行事である｡画布内の行事の処理は上の ITEM IDS AND TAGS 内で定義された現在の品目を使う｡ Enter と Leave 行事は品目について､それが現在の品目に変わったか､現在の品目ではなくなった時に発動する; 註意すべきはこれらの行事は窓についての Enter と Leave 行事とは異なることである｡マウスに関連した行事はもしあれば､現在の品目に宛てられ､鍵盤に関連した行事はもしあれば､注目されている品目に宛てられる(これに関する更なることは下の focus 部品命令を参照されたい)｡もし､仮想行事が束縛に使用されていると､束縛は仮想行事がマウス関連か鍵盤関連行事に基礎を置いて定義されている場合にのみ発動することが可能である｡　　　　 The only events for which bindings may be specified are those related to the mouse and keyboard (such as Enter, Leave, ButtonPress, Motion, and KeyPress) or virtual events. The handling of events in canvases uses the current item defined in ITEM IDS AND TAGS above. Enter and Leave events trigger for an item when it becomes the current item or ceases to be the current item; note that these events are different than Enter and Leave events for windows. Mouse-related events are directed to the current item, if any. Keyboard-related events are directed to the focus item, if any (see the focus widget command below for more on this). If a virtual event is used in a binding, that binding can trigger only if the virtual event is defined by an underlying mouse-related or keyboard-related event.

  特定の行事に合致する多重の束縛も可能である｡これは､譬えば､もし一つの束縛が品目の識別番号と結合し､同時に他のものが品目の貼り札の一つと結合するとこれが生じる｡これが生じたとき､全ての合致する束縛が起動される｡ all の貼り札に結合した束縛が最初に起動され､それぞれの品目の貼り札についての結合が続き､品目の識別番号と結合した束縛が続く｡もし､一つの貼り札について多重に結合する束縛があると､一つの最も明確な結合が起動される｡結合記述譜の中のcontinue 命令が記述譜を終了させ､又､break 命令は記述譜を終了させ､行事に関する残っている記述譜を幾つでも丁度 bind 命令の如く飛越す｡　　　　 It is possible for multiple bindings to match a particular event. This could occur, for example, if one binding is associated with the item's id and another is associated with one of the item's tags. When this occurs, all of the matching bindings are invoked. A binding associated with the all tag is invoked first, followed by one binding for each of the item's tags (in order), followed by a binding associated with the item's id. If there are multiple matching bindings for a single tag, then only the most specific binding is invoked. A continue command in a binding script terminates that script, and a break command terminates that script and skips any remaining scripts for the event, just as for the bind command.

  もし､ bind 命令を使って画布窓の結合が作成されていると､それは bind 部品命令を使って画布の品目について作成された結合に追加して起動される｡品目についての結合は全体としての窓についてのどの結合より前に起動される｡　　　　 If bindings have been created for a canvas window using the bind command, then they are invoked in addition to bindings created for the canvas's items using the bind widget command. The bindings for items will be invoked before any of the bindings for the window as a whole.

pathName canvasx screenx ?gridspacing?
  この命令は､画布内にある､窓の x-座標 screenx を与えられ､その位置を展示する画布の x-座標を返す｡もし gridspacing が指定されると､画譜座標は最も近い gridspacing 単位の倍数に丸められる｡　　　　 Given a window x-coordinate in the canvas screenx, this command returns the canvas x-coordinate that is displayed at that location. If gridspacing is specified, then the canvas coordinate is rounded to the nearest multiple of gridspacing units.

pathName canvasy screeny ?gridspacing?
  この命令は､画布内にある､窓の y-座標 screeny を与えられ､その位置を展示する画布の y-座標を返す｡もし gridspacing が指定されると､画譜座標は最も近い gridspacing 単位の倍数に丸められる｡　　　　 Given a window y-coordinate in the canvas screeny this command returns the canvas y-coordinate that is displayed at that location. If gridspacing is specified, then the canvas coordinate is rounded to the nearest multiple of gridspacing units.

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

pathName configure ?option? ?value? ?option value ...?
  部品の構成設定の指示項目の値を問合せ又は修正する｡もし option が指定されていないと､ pathName についての利用可能な全ての指示項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､本命令はその名前の指示項目を記述しているリストを返す(このリストは option の指定なしの場合に返される値の該当箇所の仔リストに等しい)｡もし､一つ或はそれ以上の option-value 対が指定されると､命令は､与えられた指示項目が与えられた値を有する様に修正する; この場合､命令は空文字列を返す｡ option は canvas 命令によって受入れられるどの様な値でもよい｡　　　　 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 canvas command.

pathName coords tagOrId ?x0 y0 ...?

pathName coords tagOrId ?coordList?
  品目を定義する座標を問合せ又は修正する｡もし座標が指定されないと本命令は tagOrId によって名前が付けられた品目の座標を要素とするリストを返す｡もし､座標が指定されると､指名された品目の現在の座標を置換える｡もし､tagOrId が多重の品目を参照していると展示リストの最初のものが使われる｡　　　　 　　　　 Query or modify the coordinates that define an item. If no coordinates are specified, this command returns a list whose elements are the coordinates of the item named by tagOrId. If coordinates are specified, then they replace the current coordinates for the named item. If tagOrId refers to multiple items, then the first one in the display list is used.

  註意すべきは､矩形と楕円と円弧については､返される座標のリストは固定の順序を有し､即ち､左､頂､右､底の座標であり､最初に与えられた順番ではない｡また､座標は常に､単位を附けずに画面座標単位(即ち画素)で返される｡もし元の座標が喩えば､糎又は吋で指定されても､それに拘らず､返される値は画素単位になる｡　　　　 Note that for rectangles, ovals and arcs the returned list of coordinates has a fixed order, namely the left, top, right and bottom coordinates, which may not be the order originally given. Also the coordinates are always returned in screen units with no units (that is, in pixels). So if the original coordinates were specified for instance in centimeters or inches, the returned values will nevertheless be in pixels.

pathName create type x y ?x y ...? ?option value ...?

pathName create type coordList ?option value ...?
  pathName 内に型が type の新しい品目を生成する｡type の後の引数の正確な書式は type に依存する､しかし通常それらは､零或はそれ以上の品目の指示項目についての指定がその後に継続している様な､一つ或はそれ上の点の座標で構成される｡この命令の更なる構文については下の個別の品目の型の小節を参照されたい｡この命令は新しい品目の識別子を返す｡　　　　 Create a new item in pathName of type type. The exact format of the arguments after type depends on type, but usually they consist of the coordinates for one or more points, followed by specifications for zero or more item options. See the subsections on individual item types below for more on the syntax of this command. This command returns the id for the new item.

pathName dchars tagOrId first ?last?
  tagOrId で与えられるそれぞれの品目について､ first から last によって与えられる両端を含む領域にある文字や座標を削除する｡もしtagOrId で与えられる幾つかの品目が番号指定する操作を運用していないと､それらはこの操作を無視する｡文書品目は first と last を文字の位置と解釈し､線と多角形品目ではそれを座標の番号( x,y の対として)と解釈する｡番号は上の INDICES 内に記述されている｡もしlast が省略されると､first が省略時設定とされる｡この命令は空文字列を返す｡　　　　 For each item given by tagOrId, delete the characters, or coordinates, in the range given by first and last, inclusive. If some of the items given by tagOrId do not support indexing operations then they ignore this operation. Text items interpret first and last as indices to a character, line and polygon items interpret them as indices to a coordinate (an x,y pair). Indices are described in INDICES above. If last is omitted, it defaults to first. This command returns an empty string.

pathName delete ?tagOrId tagOrId ...?
  tagOrId で与えられるそれぞれの品目を削除し空文字列を返す｡　　　　 Delete each of the items given by each tagOrId, and return an empty string.

pathName dtag tagOrId ?tagToDelete?
  tagOrId で与えられるそれぞれの品目について､品目に結合しているリストから tagToDelete で与えられる貼り札を削除する｡品目が貼り札 tagToDelete を有しないの場合､その品目は本命令の影響を受けない｡もし tagToDelete が省略されると tagOrId が省略時設定となる｡この命令は空文字列を返す｡　　　　 For each of the items given by tagOrId, delete the tag given by tagToDelete from the list of those associated with the item. If an item does not have the tag tagToDelete then the item is unaffected by the command. If tagToDelete is omitted then it defaults to tagOrId. This command returns an empty string.

pathName find searchCommand ?arg arg ...?
  この命令は SearchCommand と arg によって指定された制約に符合する全ての品目から構成されるリストを返す｡ SearchCommand と arg は addtag 命令によって受入れられるどの形式でもよい｡品目は棚の順に従って返される､最も下の品目が最初になる｡ This command returns a list consisting of all the items that meet the constraints specified by searchCommand and arg's. SearchCommand and args have any of the forms accepted by the addtag command. The items are returned in stacking order, with the lowest item first.

pathName focus ?tagOrId?
  画布部品についての鍵盤の注目を tagOrId で与えられる品目に設定する｡もしtagOrId が幾つもの品目を参照している場合､注目は挿入遊走子を運用している展示リストの最初のその様な品目に設定する｡もし､tagOrId がどの品目も参照しない､又はもし､どれも挿入遊走子を運用しない場合､注目は変化しない｡もし tagOrIdrId が空文字列である場合注目の品目は刷新されどの品目も注目を有さない｡もし tagOrId が指定されない場合､現在注目を有する品目について識別番号を返すか､注目を有する品目がないと空文字列を返す｡　　　　 Set the keyboard focus for the canvas widget to the item given by tagOrId. If tagOrId refers to several items, then the focus is set to the first such item in the display list that supports the insertion cursor. If tagOrId does not refer to any items, or if none of them support the insertion cursor, then the focus is not changed. If tagOrId is an empty string, then the focus item is reset so that no item has the focus. If tagOrId is not specified then the command returns the id for the item that currently has the focus, or an empty string if no item has the focus.

  一度品目に注目が設定されると､その品目は挿入遊走子を展示する､そして､全ての鍵盤行事はその品目に向けられる｡画布内部の注目のある品目と画面上の注目のある窓(focus 命令により設定される)は完全に独立である: 与えられる品目は (a) その画布が注目のある窓である 且つ(b) 品目は画布内部の注目のある品目である でない限り実際には入力の注目を有さない｡大部分の場合､推奨することは､注目の窓を画布に設定する為に focus 部品命令に focus 命令を続けることである(もし未だなら)｡　　　　 Once the focus has been set to an item, the item will display the insertion cursor and all keyboard events will be directed to that item. The focus item within a canvas and the focus window on the screen (set with the focus command) are totally independent: a given item does not actually have the input focus unless (a) its canvas is the focus window and (b) the item is the focus item within the canvas. In most cases it is advisable to follow the focus widget command with the focus command to set the focus window to the canvas (if it was not there already).

pathName gettags tagOrId
  tagOrId で与えられる品目に結合した貼り札を要素とするリストを返す｡もし tagOrId が複数の品目を参照していると展示リスト内の最初のその様な品目を返す｡もし tagOrId がどの品目も参照していないか､もし､品目が貼り札を含んでいない場合､空文字列が返される｡　　　　 Return a list whose elements are the tags associated with the item given by tagOrId. If tagOrId refers to more than one item, then the tags are returned from the first such item in the display list. If tagOrId does not refer to any items, or if the item contains no tags, then an empty string is returned.

pathName icursor tagOrId index
  tagOrId によって与えられる品目について､indexによって位置が与えられる文字の丁度前に､挿入遊走子の位置を指定する｡もし､ tagOrId によって与えられた幾つかの或は全ての品目が挿入遊走子を運用していないと､本命例はそれらに影響を与えない｡ tagOrId についての公式な書式の記述は上の INDICES を参照されたい｡註意: 挿入遊走子は現在鍵盤注目を有する品目(部品命令 focus を参照のこと)の中にあるときにのみ展示される､しかし､品目が注目を有さない時でも､遊走子の位置は設定されるかもしれない｡この命令は空文字列を返す｡　　　　 Set the position of the insertion cursor for the item(s) given by tagOrId to just before the character whose position is given by index. If some or all of the items given by tagOrId do not support an insertion cursor then this command has no effect on them. See INDICES above for a description of the legal forms for index. Note: the insertion cursor is only displayed in an item if that item currently has the keyboard focus (see the focus widget command, above), but the cursor position may be set even when the item does not have the focus. This command returns an empty string.

pathName imove tagOrId index x y
  この命令は tagOrId によって示されるそれぞれの品目の index 番目の座標を位置(x,y)に再配置する｡それぞれの品目は､上の INDICES 内に記述される規則に沿って index を独立に解釈する｡標準の組の品目以外では､線と多角形品目のみがこの方法でその座標を再配列させる｡　　　　 This command causes the index'th coordinate of each of the items indicated by tagOrId to be relocated to the location (x,y). Each item interprets index independently according to the rules described in INDICES above. Out of the standard set of items, only line and polygon items may have their coordinates relocated this way.

pathName index tagOrId index
  この命令は tagOrId 内部の index に対応する数的番号を与える十進数文字列を返す｡ index は上の INDICES 内で記述した様に望ましい位置の文字表現を与える｡文書品目は index を文字への番号として解釈し､線と多角形品目はそれを座標への番号と解釈する( x,y 対)｡返り値は 0 と､品目内部の､文字個数か座標との両端を含む間､になることが保障される｡もし tagOrId が複数の品目を参照していると､その番号は番号操作を運用している最初の品目で処理される(展示リストの順序で)｡　　　　 This command returns a decimal string giving the numerical index within tagOrId corresponding to index. Index gives a textual description of the desired position as described in INDICES above. Text items interpret index as an index to a character, line and polygon items interpret it as an index to a coordinate (an x,y pair). The return value is guaranteed to lie between 0 and the number of characters, or coordinates, within the item, inclusive. If tagOrId refers to multiple items, then the index is processed in the first of these items that supports indexing operations (in display list order).

pathName insert tagOrId beforeThis string
  tagOrId によって与えられるそれぞれの品目に関して､もし品目が文書か座標を運用している場合､挿入は､品目の文書に string が挿入される､その位置は beforeThis が指す文字か座標の丁度手前である｡文書品目では beforeThis を文字の位置と解釈し､線と多角形品目ではそれを座標並びの順番と解釈する( x,y 対)｡線と多角形では string は適切な座標並びでなくてはならない｡beforeThis について許容されている形式についての情報は上の INDICES を参照されたい｡この命令は空文字列を返す｡　　　　 For each of the items given by tagOrId, if the item supports text or coordinate, insertion then string is inserted into the item's text just before the character, or coordinate, whose index is beforeThis. Text items interpret beforeThis as an index to a character, line and polygon items interpret it as an index to a coordinate (an x,y pair). For lines and polygons the string must be a valid coordinate sequence. See INDICES above for information about the forms allowed for beforeThis. This command returns an empty string.

pathName itemcget tagOrId option
  tagOrId によって与えられる品目について名前が option の構成設定指示項目の現在の値を返す｡この命令は cget 命令と似ているが違いは､部品全体ではなく特定の品目に適用することである｡ option は品目が作成された時 create 部品命令によって受入れられたどの様な値を有するかもしれない｡tagOrId が複数の品目を参照する貼り札の場合､最初の(最も下の)その様な品目が使われる｡　　　　 Returns the current value of the configuration option for the item given by tagOrId whose name is option. This command is similar to the cget widget command except that it applies to a particular item rather than the widget as a whole. Option may have any of the values accepted by the create widget command when the item was created. If tagOrId is a tag that refers to more than one item, the first (lowest) such item is used.

pathName itemconfigure tagOrId ?option? ?value? ?option value ...?
  この命令は configure 部品命令と似ているが､違いは､全ての画布部品についての指示項目の修正の代りに､ tagOrId によって与えられる品目についての品目固有の指示項目の修正をすることである｡もし､何も option が与えられないと､ tagOrId によって与えられる最初の品目についての全ての利用可能な指示項目を記述したリストを返す(そのリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､本命令は option の名前のものを記述したリストを返す(このリストは option の指定なしで返った値の該当箇所の小リストに等しい)｡もし､一つ或はそれ以上の option-value 対が指定されると､命令は､与えられた指示項目が与えられた値を有する様に修正する; この場合､命令は空文字列を返す｡ option と value は品目が生成された時に create 部品命令内で許容されたものと同じものである; 適正な指示項目の詳細については下の個別の品目の型を記述した節を参照されたい｡　　　　 　 This command is similar to the configure widget command except that it modifies item-specific options for the items given by tagOrId instead of modifying options for the overall canvas widget. If no option is specified, returns a list describing all of the available options for the first item given by tagOrId (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 each of the items given by tagOrId; in this case the command returns an empty string. The options and values are the same as those permissible in the create widget command when the item(s) were created; see the sections describing individual item types below for details on the legal options.

pathName lower tagOrId ?belowThis?
  tagOrId によって与えられる全ての品目を､展示リスト内の belowThis によって与えられる品目の直前の新しい位置に移す｡もし､ tagOrId が複数の品目を参照している場合は､全てが移動されるが相対的順番は変化しない｡ belowThis は貼り札または識別番号である; もしそれが複数の品目を参照している場合これら品目の展示リスト中の初めの(最も下の)ものが移動される品目の仕向け先として使われる｡註意: この命令は窓の品目には効果を及ぼさない｡窓の品目は常に､他の品目の型に覆れている､又､窓の品目の棚の順序は raise と lower 命令によって定められ､画布についての raise 部品命令と lower 部品命令ではない｡この命令は空文字列を返す｡　　　　 Move all of the items given by tagOrId to a new position in the display list just before the item given by belowThis. If tagOrId refers to more than one item then all are moved but the relative order of the moved items will not be changed. BelowThis is a tag or id; if it refers to more than one item then the first (lowest) of these items in the display list is used as the destination location for the moved items. Note: this command has no effect on window items. Window items always obscure other item types, and the stacking order of window items is determined by the raise command and lower command, not the raise widget command and lower widget command for canvases. This command returns an empty string.

pathName move tagOrId xAmount yAmount
  画布座標空間内の tagOrId によって与えられるそれぞれの品目を､品目に結合したそれぞれの点の x-座標に xAmount を加え､品目に結合したそれぞれの点の y-座標に yAmount を加えることにより移動する｡この命令は空文字列を返す｡　　　　 Move each of the items given by tagOrId in the canvas coordinate space by adding xAmount to the x-coordinate of each point associated with the item and yAmount to the y-coordinate of each point associated with the item. This command returns an empty string.

pathName moveto tagOrId xPos yPos
  tagOrId によって与えられる画布座標空間内の品目を移動して､貼り札 tagOrId を伴う最初の(表示リスト内の最も底にある)品目の最初の座標対が位置 (xPos,yPos) になる様に据える｡ xPos と yPos は空文字列でもよく､その場合､対応する座標は変更されない｡ tagOrId に合致する全ての品目は互いに相対的に同じ位置を保つ｡この命令は空文字列を返す｡　　　　 Move the items given by tagOrId in the canvas coordinate space so that the first coordinate pair (the upper-left corner of the bounding box) of the first item (the lowest in the display list) with tag tagOrId is located at position (xPos,yPos). xPos and yPos may be the empty string, in which case the corresponding coordinate will be unchanged. All items matching tagOrId remain in the same positions relative to each other. This command returns an empty string.

pathName postscript ?option value option value ...?
  画布の部分又は全てについてのPS印刷譜(訳註 Postscript は印刷機を制御する頁記述言語)を生成する｡もし -file 指示項目が指定されていると､PS印刷譜はファイルに書かれ､空文字列が返る; そうでなければ命令の結果としてPS印刷譜が返る｡もし画布を有している解釈実行機能が安全な解釈実行機能に旗標されていると操作は失敗する､理由は安全な解釈実行機能はファイル書込みが許可されていないから｡もし -channel 指示項目が指定されていると､引数は既に書込み用に開かれた通信路の名前を示す｡PS印刷譜は通信路に書かれ､通信路は操作の終った時点で更なる書込みに備えて開かれたまま残される｡PS印刷譜は文書構造化規約第 3.0 版を使用した EPSで生成される｡註意: 省略時設定ではPS印刷譜は単に画面上の画布の窓内に現れる情報を生成するのみである｡もし画布が新しく生成されそれが初期の寸法の1x1 画素のままであると､PS印刷譜内に何も現れないかもしれない｡この問題を回避するために､画譜窓について最終寸法に至る迄待つために update 命令を起動するか､さもなければ､ -width と -height 指示項目を使って印刷する為の画布の寸法を指定してもよい｡ option-value 引数対はPS印刷譜を制御する為の追加的情報を提供する｡次の指示項目が運用されている:　　　　 Generate a Postscript representation for part or all of the canvas. If the -file option is specified then the Postscript is written to a file and an empty string is returned; otherwise the Postscript is returned as the result of the command. If the interpreter that owns the canvas is marked as safe, the operation will fail because safe interpreters are not allowed to write files. If the -channel option is specified, the argument denotes the name of a channel already opened for writing. The Postscript is written to that channel, and the channel is left open for further writing at the end of the operation. The Postscript is created in Encapsulated Postscript form using version 3.0 of the Document Structuring Conventions. Note: by default Postscript is only generated for information that appears in the canvas's window on the screen. If the canvas is freshly created it may still have its initial size of 1x1 pixel so nothing will appear in the Postscript. To get around this problem either invoke the update command to wait for the canvas window to reach its final size, or else use the -width and -height options to specify the area of the canvas to print. The option-value argument pairs provide additional information to control the generation of Postscript. The following options are supported:

  -channel channelName
    ポストスクリプトを書込む通信路の名前を指定する｡もしこの指示項目と -file 指示項目が指定されていないとポストスクリプトが命令の結果として返される｡　　　　 　 Specifies the name of the channel to which to write the Postscript. If this option and the -file option are not specified then the Postscript is returned as the result of the command.

  -colormap varName
    varName はPS印刷譜内で使用する為の色の位置対応付けを指定する配列変数の名前でなければならない｡ varName のそれぞれの要素は､特定の色の値を設定する為のPS印刷譜命令を構成しなければならない(譬えば “1.0 1.0 0.0 setrgbcolor” )｡PS印刷譜内で色情報を出力する時､ Tk は varName の要素に色と同じ名前がないかを検査する｡もしあれば､ Tk は要素の値をPS印刷譜命令として色の設定に使用する｡もしこの指示項目が指定されていないか与えられた色についての varName 内に見出しがないと､ Tk は X の色から赤､緑､青の輝度を使う｡ VarName must be the name of an array variable that specifies a color mapping to use in the Postscript. Each element of varName must consist of Postscript code to set a particular color value (e.g. “1.0 1.0 0.0 setrgbcolor”). When outputting color information in the Postscript, Tk checks to see if there is an element of varName with the same name as the color. If so, Tk uses the value of the element as the Postscript command to set the color. If this option has not been specified, or if there is no entry in varName for a given color, then Tk uses the red, green, and blue intensities from the X color.

  -colormode mode
    色情報を如何に出力するかを指定する｡mode は color (総天然色の出力)か gray (全ての色を等価的な灰色に変換する)か mono (全ての色を白か黒に変換する)のどれかでなくてはならない｡　　　　 Specifies how to output color information. Mode must be either color (for full color output), gray (convert all colors to their gray-scale equivalents) or mono (convert all colors to black or white).

  -file fileName
    PS印刷譜を書込むファイルの名前を指定する｡もしこの指示項目も -channel 指示項目も指定されていないとPS印刷譜が命令の結果として返される｡　　　　 Specifies the name of the file in which to write the Postscript. If this option and the -channel option are not specified then the Postscript is returned as the result of the command.

  -fontmap varName
    varName はPS印刷譜内で使用する為の文字形状の対応付けを指定する配列変数の名前でなければならない｡ varName のそれぞれの要素は二つの要素の Tcl リストを構成しなくてはならず､それはPS印刷譜文字形状の名前と文字寸法である｡特定の文字形状についてPS印刷譜命令出力時に､ Tk は varName が文字形状と同じ名前の要素を含んでいないかを検査する｡もしその様な要素があれば､その要素に含まれた文字形状の情報がPS印刷譜に使われる｡そうでなければ､ Tk はどの様なPS印刷譜文字形状を使うべきかの推定を試みる｡ Tk の推定は一般に Times や Helvetica や Courier の如く良く知られた文字形状についてのみ作動し､又､ X の文字形状の名前はポイント寸法迄のどの横棒も省略されていない場合のみ作動する｡譬えば -*-Courier-Bold-R-Normal--*-120-* は作動するが *Courier-Bold-R-Normal*120* は作動しない; Tk は文字形状名前を解析する為には横棒を要する)｡ VarName must be the name of an array variable that specifies a font mapping to use in the Postscript. Each element of varName must consist of a Tcl list with two elements, which are the name and point size of a Postscript font. When outputting Postscript commands for a particular font, Tk checks to see if varName contains an element with the same name as the font. If there is such an element, then the font information contained in that element is used in the Postscript. Otherwise Tk attempts to guess what Postscript font to use. Tk's guesses generally only work for well-known fonts such as Times and Helvetica and Courier, and only if the X font name does not omit any dashes up through the point size. For example, -*-Courier-Bold-R-Normal--*-120-* will work but *Courier-Bold-R-Normal*120* will not; Tk needs the dashes to parse the font name).

  -height size
    印刷する為の画布の領域の高さを指定する｡省略時設定は画布窓の高さ｡　　　　 Specifies the height of the area of the canvas to print. Defaults to the height of the canvas window.

  -pageanchor anchor
    印刷される領域の画布のどの点が頁の上の位置取りした点(そこは､ -pagex と -pagey 指示項目によって与えられる)に重なるべきかを指定する｡譬えば､ -pageanchor n は印刷される画布(画布窓として現れる様に)の領域の中央頂上が位置指定した点に重なるべきことを意味する｡省略時設定はcenter ｡　　　　 Specifies which point of the printed area of the canvas should appear over the positioning point on the page (which is given by the -pagex and -pagey options). For example, -pageanchor n means that the top center of the area of the canvas being printed (as it appears in the canvas window) should be over the positioning point. Defaults to center.

  -pageheight size
    印刷領域がPS印刷譜上の size 高さになるようにPS印刷譜が x も y も拡大されることを指定する｡ size は浮動小数数に糎の c か､吋の i か､粍の m か､印刷ポイント(1/72吋)を表す p か､が添えられる｡省略時設定の高さは画面上の印刷される領域である｡もし -pageheight と -pagewidth の両方が指定されると -pagewidth の拡大倍率が使われる(縦横違う拡大倍率は実装されていない)｡　　　　 Specifies that the Postscript should be scaled in both x and y so that the printed area is size high on the Postscript page. Size consists of a floating-point number followed by c for centimeters, i for inches, m for millimeters, or p or nothing for printer's points (1/72 inch). Defaults to the height of the printed area on the screen. If both -pageheight and -pagewidth are specified then the scale factor from -pagewidth is used (non-uniform scaling is not implemented).

  -pagewidth size
    PS印刷譜上の印刷領域が size 幅になるようにPS印刷譜が x も y も拡大されることを指定する｡ size は -pageheight と同じ形式を有する｡省略時設定の幅は画面上の印刷される領域である｡もし -pageheight と -pagewidth の両方が指定されると -pagewidth の拡大倍率が使われる(縦横違う拡大倍率は実装されていない)｡　　　　 Specifies that the Postscript should be scaled in both x and y so that the printed area is size wide on the Postscript page. Size has the same form as for -pageheight. Defaults to the width of the printed area on the screen. If both -pageheight and -pagewidth are specified then the scale factor from -pagewidth is used (non-uniform scaling is not implemented).

  -pagex position
    position はPS印刷譜上の位置指定した点の x-座標を -pageheight について許容されるどれかの形式を使って与える｡ -pagey や -pageanchor 指示項目と共に使ってPS印刷譜の頁の印刷される領域を定める｡省略時設定は頁中央｡ Position gives the x-coordinate of the positioning point on the Postscript page, using any of the forms allowed for -pageheight. Used in conjunction with the -pagey and -pageanchor options to determine where the printed area appears on the Postscript page. Defaults to the center of the page.

  -pagey position
    position はPS印刷譜上の位置指定した点の y-座標を -pageheight について許容されるどれかの形式を使って与える｡ -pagex や -pageanchor 指示項目と共に使ってPS印刷譜の頁の印刷される領域を定める｡省略時設定は頁中央｡ Position gives the y-coordinate of the positioning point on the Postscript page, using any of the forms allowed for -pageheight. Used in conjunction with the -pagex and -pageanchor options to determine where the printed area appears on the Postscript page. Defaults to the center of the page.

  -rotate boolean
    印刷領域が 90 度回転されるか否かを指定する論理値｡非回転出力内では印刷される領域の x-軸が頁の短い方の方向に沿う (“肖像画” 配置) ; 回転出力内では印刷される領域の x-軸が頁の長い方の方向に沿う (“風景画” 配置) ｡省略時設定は非回転｡ Boolean specifies whether the printed area is to be rotated 90 degrees. In non-rotated output the x-axis of the printed area runs along the short dimension of the page (“portrait” orientation); in rotated output the x-axis runs along the long dimension of the page (“landscape” orientation). Defaults to non-rotated.

  -width size
    印刷する為の画布の領域の幅を指定する｡省略時設定は画布窓の幅｡　　　　 Specifies the width of the area of the canvas to print. Defaults to the width of the canvas window.

  -x position
    印刷される画布の領域の左端の x-座標を､窓の座標でなく､画布の座標で指定する｡省略時設定は窓の左端の座標｡　　　　 Specifies the x-coordinate of the left edge of the area of the canvas that is to be printed, in canvas coordinates, not window coordinates. Defaults to the coordinate of the left edge of the window.

  -y position
    印刷される画布の領域の上端の y-座標を､窓の座標でなく､画布の座標で指定する｡省略時設定は窓の上端の座標｡　　　　 Specifies the y-coordinate of the top edge of the area of the canvas that is to be printed, in canvas coordinates, not window coordinates. Defaults to the coordinate of the top edge of the window.

pathName raise tagOrId ?aboveThis?
  tagOrId によって与えられる全ての品目を､展示リスト内の aboveThis によって与えられる品目の直後の新しい位置に移す｡もし､ tagOrId が複数の品目を参照している場合は､全てが移動されるが相対的順番は変化しない｡ aboveThis は貼り札または識別番号である; もしそれが複数の品目を参照している場合これら品目の展示リスト中の最後の(最も上の)ものが移動される品目の仕向け先として使われる｡この命令は空文字列を返す｡　　　　 Move all of the items given by tagOrId to a new position in the display list just after the item given by aboveThis. If tagOrId refers to more than one item then all are moved but the relative order of the moved items will not be changed. AboveThis is a tag or id; if it refers to more than one item then the last (topmost) of these items in the display list is used as the destination location for the moved items. This command returns an empty string.

  註意: この命令は窓の品目には効果を及ぼさない｡窓の品目は常に､他の品目の型に覆れている､又､窓の品目の重複の順序は raise 命令と lower 命令によって定まり､画布についての raise 部品命令と lower 部品命令ではない｡　　　　 Note: this command has no effect on window items. Window items always obscure other item types, and the stacking order of window items is determined by the raise command and lower command, not the raise widget command and lower widget command for canvases.

pathName rchars tagOrId first last string
  この命令は tagOrId によって示されるそれぞれの品目の first と last の間の文書か座標が string によって置換えられる｡それぞれの品目の first と last は上述の INDICES 項目に記述された規則に従って独立に解釈される｡標準の組の品目では､文書品目は指示された文書と交換するすることによりこの操作を運用している､線と多角形品目はその座標リストを交換することによりこの操作を運用している(その場合には､ string は取替えとして使用する座標のリストである)｡その他の品目ではこの操作は無視される｡　　　　 This command causes the text or coordinates between first and last for each of the items indicated by tagOrId to be replaced by string. Each item interprets first and last independently according to the rules described in INDICES above. Out of the standard set of items, text items support this operation by altering their text as directed, and line and polygon items support this operation by altering their coordinate list (in which case string should be a list of coordinates to use as a replacement). The other items ignore this operation.

pathName scale tagOrId xOrigin yOrigin xScale yScale
  画布座標空間内の tagOrId によって与えられる品目全てを再拡大する｡ xOrigin と yOrigin は拡大操作の為の原点と看做され､ xScale と yScale は拡大倍率と看做される(拡大倍率 1.0 はその座標に無変更を強いる)｡それぞれの品目を定義しているそれぞれの点に対して､ x-座標は xOrigin からの距離が倍率 xScale によって変化する様に調整される｡同様にそれぞれの y-座標は yOrigin からの距離が倍率 yScale によって変化する様に調整される｡この命令は空文字列を返す｡　　　　 Rescale the coordinates of all of the items given by tagOrId in canvas coordinate space. XOrigin and yOrigin identify the origin for the scaling operation and xScale and yScale identify the scale factors for x- and y-coordinates, respectively (a scale factor of 1.0 implies no change to that coordinate). For each of the points defining each item, the x-coordinate is adjusted to change the distance from xOrigin by a factor of xScale. Similarly, each y-coordinate is adjusted to change the distance from yOrigin by a factor of yScale. This command returns an empty string.

  註意すべきは､幾つかの品目では座標は一対しかないので(譬えば､文書､影像､窓)､この命令によるその拡大はそこに移動ができるだけである｡　　　　 Note that some items have only a single pair of coordinates (e.g., text, images and windows) and so scaling of them by this command can only move them around.

pathName scan option args
  この命令は画布上の走査の実装に使われる｡ option によって二つの形式がある:　　　　 This command is used to implement scanning on canvases. It has two forms, depending on option:

  pathName scan mark x y
    x と y と画布の現在の視野を記録する; 後の scan dragto 命令と共に使用される｡典型的にはこの命令は部品内のマウス釦押下と結合している､そして､ x と y はマウスの座標である｡この命令は空文字列を返す｡　　　　 Records x and y and the canvas's current view; used in conjunction with later scan dragto commands. Typically this command is associated with a mouse button press in the widget and x and y are the coordinates of the mouse. It returns an empty string.

  pathName scan dragto x y ?gain?
    この命令は､この引数 x ､ y と(それは典型的にはマウス座標である)､その部品の為の最後の scan mark 命令に対する引数 x ､ y との距離を計算する｡次に座標の距離の gain 倍に視野を調整する､ここで gain の省略時設定は 10 である｡この命令は､典型的には部品内のマウスの移動行事に結合しており､その窓を高速でよぎって画布を引っ張る効果を産出す｡返り値は空文字列｡　　　　 This command computes the difference between its x and y arguments (which are typically mouse coordinates) and the x and y arguments to the last scan mark command for the widget. It then adjusts the view by gain times the difference in coordinates, where gain defaults to 10. This command is typically associated with mouse motion events in the widget, to produce the effect of dragging the canvas at high speed through its window. The return value is an empty string.

pathName select option ?tagOrId arg?
  option に基き､幾つかの内の一つの方法で選択を操作する｡この命令は下に記述するどれかの形式をとる｡下の記述の全てに於いて､ tagOrId は位置付けと選択を運用している品目を参照していなければならない; もしそれが多数の品目を参照している場合は､位置付けと選択を運用しているような最初のものが使用される｡ index は上の INDICES で記述したように tagOrId 内部の位置を文書記述で与える｡　　　　 Manipulates the selection in one of several ways, depending on option. The command may take any of the forms described below. In all of the descriptions below, tagOrId must refer to an item that supports indexing and selection; if it refers to multiple items then the first of these that supports indexing and the selection is used. Index gives a textual description of a position within tagOrId, as described in INDICES above.

  pathName select adjust tagOrId index
    tagOrId 内の選択の末尾を index によって与えられる文字に最も近い位置に置き､次いで､その選択の末尾が index であるように調整する(即ち､ index を含むが､ index の後には行かない)｡他の選択の末尾は将来の select to 命令の為の錨点を形成する｡もし現在､選択が tagOrId 内になければこの命令は select to 部品命令と同じ振舞いをする｡　　　　 Locate the end of the selection in tagOrId nearest to the character given by index, and adjust that end of the selection to be at index (i.e. including but not going beyond index). The other end of the selection is made the anchor point for future select to commands. If the selection is not currently in tagOrId then this command behaves the same as the select to widget command. Returns an empty string.

  pathName select clear
    選択がこの部品内にあれば解除する｡もし選択がこの部品にないと､命令は効果を持たない｡空文字列を返す｡　　　　 Clear the selection if it is in this widget. If the selection is not in this widget then the command has no effect. Returns an empty string.

  pathName select from tagOrId index
    部品の為の選択錨点を tagOrId によって与えられる品目の index によって与えられる文字の丁度前に設定する｡この命令は選択は変更しない; 将来の select to 命令に対する選択の末尾を固定する｡空文字列を返す｡　　　　 Set the selection anchor point for the widget to be just before the character given by index in the item given by tagOrId. This command does not change the selection; it just sets the fixed end of the selection for future select to commands. Returns an empty string.

  pathName select item
    もし選択が画布内の品目にあると､選択された品目の識別番号を返す｡もし､選択が画布内にないと､空文字列が返る｡　　　　 Returns the id of the selected item, if the selection is in an item in this canvas. If the selection is not in this canvas then an empty string is returned.

  pathName select to tagOrId index
    tagOrId の中の､選択錨点と index の間の文字を範囲とする選択を設定する｡新しい選択は index で与えられる文字を含む; index が錨点と同じか大きい時にのみ､新しい選択は､錨点により与えられる文字を含む｡錨点はこの部品に対する最も新しい select adjust か select from 命令により定められる｡現在もし部品の為の選択錨点が tagOrId 内にない場合､ index で与えられるその文字が設定される｡空文字列を返す｡　　　　 Set the selection to consist of those characters of tagOrId between the selection anchor point and index. The new selection will include the character given by index; it will include the character given by the anchor point only if index is greater than or equal to the anchor point. The anchor point is determined by the most recent select adjust or select from command for this widget. If the selection anchor point for the widget is not currently in tagOrId, then it is set to the same character given by index. Returns an empty string.

pathName type tagOrId
  tagOrId によって与えられる品目の型を返す､譬えば rectangle や text とか｡もし､ tagOrId が複数の品目を参照すると､展示リスト内の最初の品目の型が返される｡もし tagOrId がどの品目も全然参照していないと空文字列が返される｡　　　　 Returns the type of the item given by tagOrId, such as rectangle or text. If tagOrId refers to more than one item, then the type of the first item in the display list is returned. If tagOrId does not refer to any items at all then an empty string is returned.

pathName xview ?args?
  この命令は画布の窓内に展示される水平の位置の情報の問合せと変更に使われる｡それは次の形式のどれかをとる:　　　　 This command is used to query and change the horizontal position of the information displayed in the canvas's window. It can take any of the following forms:

  pathName xview
    二つの要素からなるリストを返す｡それぞれの要素は 0 と 1 の間の実数の小数であり; 協調して､水平の窓内の､可視部の､区間を記述する｡譬えば第１要素が .2 ､第２要素が .6 であると､画布の領域( -scrollregion 指示項目によって定義されたと同様に)の20% は左側に画面外であり､中央 40% は窓中の可視部であり､画布の 40% は右側に画面外である｡これらは -xscrollcommand 指示項目経由で摺動盤に渡した値と同じである｡　　　　 Returns a list containing two elements. Each element is a real fraction between 0 and 1; together they describe the horizontal span that is visible in the window. For example, if the first element is .2 and the second element is .6, 20% of the canvas's area (as defined by the -scrollregion option) is off-screen to the left, the middle 40% is visible in the window, and 40% of the canvas is off-screen to the right. These are the same values passed to scrollbars via the -xscrollcommand option.

  pathName xview moveto fraction
    画布の総幅の fraction が左側に画面外になるように窓内の視野を調節する｡ fraction は 0 と 1 の間の小数でなければならない｡　　　　 Adjusts the view in the window so that fraction of the total width of the canvas is off-screen to the left. Fraction must be a fraction between 0 and 1.

  pathName xview scroll number what
    この命令は窓内の視野を右又は左に number と what に従って移動する｡ number は整数でなくてはならない｡ what は units か pages かこれらの短縮形のどれかでなければならない｡もし what が units である場合､もしそれが零より大きいと､視野は右か左に xScrollIncrement 指示項目の単位で調節する､そうでなければ窓の幅の十分の一の単位で調節する｡もし what が pages であると､視野は窓の幅の十分の九の単位で調節する｡もし number が負なら更なる左の情報が可視になり; もし number が正なら更なる右の情報が可視になる｡　　　　 This command shifts the view in the window left or right according to number and what. Number must be an integer. What must be either units or pages or an abbreviation of one of these. If what is units, the view adjusts left or right in units of the xScrollIncrement option, if it is greater than zero, or in units of one-tenth the window's width otherwise. If what is pages then the view adjusts in units of nine-tenths the window's width. If number is negative then information farther to the left becomes visible; if it is positive then information farther to the right becomes visible.

pathName yview ?args?
  この命令は画布の窓内に展示される垂直の位置の情報の問合せと変更に使われる｡それは次の形式のどれかをとる:　　　　 This command is used to query and change the vertical position of the information displayed in the canvas's window. It can take any of the following forms:

  pathName yview
    二つの要素からなるリストを返す｡それぞれの要素は 0 と 1 の間の実数の小数であり; 協調して､垂直の窓内の､可視部の､区間を記述する｡譬えば第１要素が .6 ､第２要素が 1.0 であると､画布の領域の( -scrollregion 指示項目によって定義されたと同様に)下側40% が窓中の可視部である｡これらは -yscrollcommand 指示項目経由で摺動盤に渡した値と同じである｡　　　　 Returns a list containing two elements. Each element is a real fraction between 0 and 1; together they describe the vertical span that is visible in the window. For example, if the first element is .6 and the second element is 1.0, the lowest 40% of the canvas's area (as defined by the -scrollregion option) is visible in the window. These are the same values passed to scrollbars via the -yscrollcommand option.

  pathName yview moveto fraction
    画布の総幅の fraction が上側に画面外になるように窓内の視野を調節する｡ fraction は 0 と 1 の間の小数でなければならない｡　　　　 Adjusts the view in the window so that fraction of the canvas's area is off-screen to the top. Fraction is a fraction between 0 and 1.

  pathName yview scroll number what
    この命令は窓内の視野を上又は下に number と what に従って移動する｡ number は整数でなくてはならない｡ what は units か pages かこれらの短縮形のどれかでなければならない｡もし what が units である場合､もしそれが零より大きいと､視野は上か下に yScrollIncrement 指示項目の単位で調節する､そうでなければ窓の幅の十分の一の単位で調節する｡もし what が pages であると､視野は窓の高さの十分の九の単位で調節する｡もし number が負なら更なる上の情報が可視になり｡もし number が正なら更なる下の情報が可視になる｡　　　　 This command adjusts the view in the window up or down according to number and what. Number must be an integer. What must be either units or pages. If what is units, the view adjusts up or down in units of the yScrollIncrement option, if it is greater than zero, or in units of one-tenth the window's height otherwise. If what is pages then the view adjusts in units of nine-tenths the window's height. If number is negative then higher information becomes visible; if it is positive then lower information becomes visible.

### 品目の型の概論 OVERVIEW OF ITEM TYPES

下の節では画布窓によって運用されている種々の品目の型が記述されている｡それぞれの型の品目は二つの事柄で特徴付けられる : 第１､ 型の図形を作成する為に使われる create 命令の形式; 第２､その型の品目についての構成設定の選択子の組､それは create と itemconfigure 部品命令内で使用できる｡大多数の品目は位置づけや選択やそれに関する命令､譬えば index や insert を運用していない｡ここでこれらの便益を運用している品目は､下に明示して記述している｡現在の処､文書､線､多角形品目はこの運用を提供している｡線と多角形については､位置指定便益が品目の座標の操作に使われる｡　　　　 The sections below describe the various types of items supported by canvas widgets. Each item type is characterized by two things: first, the form of the create command used to create instances of the type; and second, a set of configuration options for items of that type, which may be used in the create and itemconfigure widget commands. Most items do not support indexing or selection or the commands related to them, such as index and insert. Where items do support these facilities, it is noted explicitly in the descriptions below. At present, text, line and polygon items provide this support. For lines and polygons the indexing facility is used to manipulate the coordinates of the item.

#### 共通の品目の指示項目 COMMON ITEM OPTIONS

多くの品目が指示項目の組を共有している｡これらの指示項目は此処に説明されている､又､それぞれの型の部品が簡単に参照されている｡　　　　 Many items share a common set of options. These options are explained here, and then referred to be each widget type for brevity.

-anchor anchorPos
  anchorPos は､品目がその品目に関して位置取りした点に如何に相対的に位置取りするかを告げる; それは Tk_GetAnchor によって受入れられるどの形式でも有し得る｡譬えば､ anchorPos が center の場合､品目は位置の中心にある; anchorPos が北 n の場合､その上の真中がその点にあるように描かれる｡この指示項目の省略時設定は中央 center である｡ AnchorPos tells how to position the item relative to the positioning point for the item; it may have any of the forms accepted by Tk_GetAnchor. For example, if anchorPos is center then the item is centered on the point; if anchorPos is n then the item will be drawn so that its top center point is at the positioning point. This option defaults to center.

-dash pattern

-activedash pattern

-disableddash pattern
  この指示項目は､品目の通常状態､活性状態､無能状態について､破線模様を指定する｡ pattern は Tk_GetDash によって受付けられるどの形式でも所有しうる｡もし破線指示項目が省略されると省略時設定は実線になる｡更なる情報については DASH PATTERNS を参照されたい｡　　　　 This option specifies dash patterns for the normal, active state, and disabled state of an item. pattern may have any of the forms accepted by Tk_GetDash. If the dash options are omitted then the default is a solid outline. See DASH PATTERNS for more information.

-dashoffset offset
  -dash 指示項目によって与えられる模様に入れられる開始 offset を画素単位で指定する｡ -dash 模様がないと -dashoffset は無視される｡ offset は上の COORDINATES 節で記述されたどの形式でも所有しうる｡　　　　 The starting offset in pixels into the pattern provided by the -dash option. -dashoffset is ignored if there is no -dash pattern. The offset may have any of the forms described in the COORDINATES section above.

-fill color

-activefill color

-disabledfill color
  通常か､活性か､無能状態かの品目の領域を塗潰す為に使われる色を指定する｡ 偶-奇 内外則が適用される｡ color は Tk_GetColor によって受入れられるどの形式を有してもよい｡線品目に対しては､線を描く色を指定する｡文書品目に対しては､文書の前景の色を指定する｡もし color が空文字列として指定されると(全ての画布品目については省略時設定､但し､行と文書を除く)､その品目は塗潰されない｡[譯註:偶-奇 内外則 境界線を奇数回跨ぐと内側､偶数回跨ぐと外側に居ると看做す]　　　　 Specifies the color to be used to fill item's area. in its normal, active, and disabled states. The even-odd fill rule is used. Color may have any of the forms accepted by Tk_GetColor. For the line item, it specifies the color of the line drawn. For the text item, it specifies the foreground color of the text. If color is an empty string (the default for all canvas items except line and text), then the item will not be filled.

-outline color

-activeoutline color

-disabledoutline color
  この指示項目はその通常､活性､無能状態にある品目の輪郭を描くのに使うべき色を指定する｡ color は Tk_GetColor によって受入れられるどの形式を有してもよい｡もし color が空文字列として指定されるとその品目の為の輪郭は描かれない｡　　　　 This option specifies the color that should be used to draw the outline of the item in its normal, active and disabled states. Color may have any of the forms accepted by Tk_GetColor. If color is specified as an empty string then no outline is drawn for the item.

-offset offset
  点描の偏寄を指定する｡偏寄の値は x,y か 方角､の形式が可能であり､ここで､方角は北 n か東北 ne か e か se か s か sw か w か nw か中央 center かが可能である｡最初の方式ではその原点は現在の窓の最頂水準の原点である｡画布そのものと画布の対象については原点は画布の原点である､しかし座標の対の前に # を置くことにより代りに最頂水準の原点を使うことを指し示す｡画布の対象に対しては､点描に対してと同じ様に -offset 指示項目がよく使われる｡線と多角形画布の品目は位置を引数として指定可能である､それは点描の原点と線/多角形の一つの座標の点を結合する｡註意すべきは､点描の位置は X11 上のみで運用されている; 他のOSでは警告無しに無視される｡　　　　 Specifies the offset of stipples. The offset value can be of the form x,y or side, where side can be n, ne, e, se, s, sw, w, nw, or center. In the first case the origin is the origin of the toplevel of the current window. For the canvas itself and canvas objects the origin is the canvas origin, but putting # in front of the coordinate pair indicates using the toplevel origin instead. For canvas objects, the -offset option is used for stippling as well. For the line and polygon canvas items you can also specify an index as argument, which connects the stipple origin to one of the coordinate points of the line/polygon. Note that stipple offsets are only supported on X11; they are silently ignored on other platforms.

-outlinestipple bitmap

-activeoutlinestipple bitmap

-disabledoutlinestipple bitmap
  この指示項目はその通常状態や活性状態や無能状態にある品目の輪郭を描くことに使用されるべき､点描の模様を指定する｡品目についての輪郭は点描模様を使って描かれるべきことを指し示す;点描の模様の指定に使用する bitmap は Tk_GetBitmap によって受入れられるどの形式でもよい｡もし､-outline 指示項目が指定されていないとこの指示項目は効果がない｡もし bitmap が空文字列の場合は(省略時設定)､輪郭は実線で描かれる｡註意すべきは､描画API として X11 を使わないOSでは点描は十分には運用されていない｡　　　　 This option specifies stipple patterns that should be used to draw the outline of the item in its normal, active and disabled states. Indicates that the outline for the item should be drawn with a stipple pattern; bitmap specifies the stipple pattern to use, in any of the forms accepted by Tk_GetBitmap. If the -outline option has not been specified then this option has no effect. If bitmap is an empty string (the default), then the outline is drawn in a solid fashion. Note that stipples are not well supported on platforms that do not use X11 as their drawing API.

-outlineoffset offset
  輪郭に使用される点描の偏寄を -outline 指示項目が点描を制御する方法で指定する( offset の構文の記述は -outline 指示項目を参照されたい)｡　　　　 Specifies the offset of the stipple pattern used for outlines, in the same way that the -outline option controls fill stipples. (See the -outline option for a description of the syntax of offset.)

-stipple bitmap

-activestipple bitmap

-disabledstipple bitmap
  この指示項目は､通常状態や活性状態や無能状態にある品目を塗り潰すことに使用されるべき点描の模様を指定する｡点描の模様の指定に使用する bitmap は Tk_GetBitmap によって受入れられるどの形式でもよい｡もし､ -fill 指示項目が指定されていないとこの指示項目は効果がない｡もし bitmap が空文字列の場合は(省略時設定)､塗り潰しは実線で行われる｡註意すべきは､描画API として X11 を使わないOSでは点描は十分には運用されていない｡　　　　 This option specifies stipple patterns that should be used to fill the item in its normal, active and disabled states. bitmap specifies the stipple pattern to use, in any of the forms accepted by Tk_GetBitmap. If the -fill option has not been specified then this option has no effect. If bitmap is an empty string (the default), then filling is done in a solid fashion. For the text item, it affects the actual text. Note that stipples are not well supported on platforms that do not use X11 as their drawing API.

-state state
  これは品目に画布部品の大域状態指示項目を上書きすることを許容する｡次のどれかの値をとる: normal (通常)か disabled (無能)か hidden (隠蔽)か｡　　　　 This allows an item to override the canvas widget's global state option. It takes the same values: normal, disabled or hidden.

-tags tagList
  品目に適用する為の貼り札の組を指定する｡ tagList はその品目に関する既存のどの貼り札も置換える貼り札の名前のリストを構成する｡tagList は空リストでも好い｡　　　　 Specifies a set of tags to apply to the item. TagList consists of a list of tag names, which replace any existing tags for the item. TagList may be an empty list.

-width outlineWidth

-activewidth outlineWidth

-disabledwidth outlineWidth
  通常か､活性か､無能かの状態の品目の領域の周囲を描く為の輪郭の幅を指定する｡ outlineWidth は上の COORDINATES 節内で記述されたどの形式でもよい｡もし -outline 指示項目が空文字列として指定されるとこの指示項目は効果がない｡この指示項目の省略時設定は 1.0｡ 円弧では､広い輪郭が円弧の領域の淵を中心に描かれる｡　　　　 Specifies the width of the outline to be drawn around the item's region, in its normal, active and disabled states. outlineWidth may be in any of the forms described in the COORDINATES section above. If the -outline option has been specified as an empty string then this option has no effect. This option defaults to 1.0. For arcs, wide outlines will be drawn centered on the edges of the arc's region.

### 標準品目の型 STANDARD ITEM TYPES

#### 円弧品目 ARC ITEMS

型の arc の品目は､円弧状の領域として画面に表示される｡円弧は二つの角( -start と -extent 指示項目で指定される)によって区切られた楕円の部分であり､幾つかの方法の一つの方法で展示される( -style 指示項目で指定される)｡円弧は次の形式の部品命令によって生成される:　　　　 Items of type arc appear on the display as arc-shaped regions. An arc is a section of an oval delimited by two angles (specified by the -start and -extent options) and displayed in one of several ways (specified by the -style option). Arcs are created with widget commands of the following form:

    pathName create arc x1 y1 x2 y2 ?option value ...?
    pathName create arc coordList ?option value ...?

引数 x1 と y1 と x2 と y2 又は coordList は円弧を定義する楕円を囲む矩形領域の対角方向に反対の隅の二つの座標を与える｡座標の後に､それぞれの組が品目に関する構成設定項目を設定する幾つかの 項目-値の option-value 対が続いてもよい｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡もし､塗られているか､(完全に透明な時には) -fill と -outline 指示項目の両方が非空であれば塗られるべき箇所のどこかに､マウスの指示子が架かった時に､円弧品目は現在の品目になる｡　　　　 The arguments x1, y1, x2, and y2 or coordList give the coordinates of two diagonally opposite corners of a rectangular region enclosing the oval that defines the arc. After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. An arc item becomes the current item when the mouse pointer is over any part that is painted or (when fully transparent) that would be painted if both the -fill and -outline options were non-empty.

次の標準の指示項目が円弧に運用されている:　　　　 The following standard options are supported by arcs:

  -dash | -activedash
  -disableddash | -dashoffset
  -fill | -activefill
  -disabledfill | -offset
  -outline | -activeoutline
  -disabledoutline | -outlineoffset
  -outlinestipple | -activeoutlinestipple
  -disabledoutlinestipple | -stipple
  -activestipple | -disabledstipple
  -state | -tags
  -width | -activewidth
  -disabledwidth

次の追加の指示項目が円弧に運用されている:　　　　 The following extra options are supported for arcs:

-extent degrees
  円弧を見込む角の大きさを指定する｡円弧の範囲は -start 指示項目によって与えられる出発角度から反時計回りに degrees 度に拡がる｡ degrees は負数でもよい｡もし 360 を超えるか -360 を超えると､ degrees の360 に対する剰余が広がりとして使われる｡　　　　 Specifies the size of the angular range occupied by the arc. The arc's range extends for degrees degrees counter-clockwise from the starting angle given by the -start option. Degrees may be negative. If it is greater than 360 or less than -360, then degrees modulo 360 is used as the extent.

-start degrees
  円弧を見込む角の範囲の開始を指定する｡ degrees は時計の３時の位置から反時計回りに度を単位に測定して与えられる; 正又は負のどちらもある｡　　　　 Specifies the beginning of the angular range occupied by the arc. Degrees is given in units of degrees measured counter-clockwise from the 3-o'clock position; it may be either positive or negative.

-style type
  如何に円弧を描くかを指定する｡もし､型 が pieslice (扇形; 省略時設定)であると､円弧の領域は､楕円の外周の区間に楕円の中心と外周区間のそれぞれの末尾との間の二つの線分を加えて定義される｡もし､型 が chord (翼弦)であると､円弧の領域は楕円の周囲の区間に周区間の二つの端末を結ぶ一本の線分を加えて定義される｡もし､型 が arc (弧)であると､円弧の領域は楕円の周囲の区間のみで構成される｡この最後の場合は -fill 指示項目は無視される｡　　　　 Specifies how to draw the arc. If type is pieslice (the default) then the arc's region is defined by a section of the oval's perimeter plus two line segments, one between the center of the oval and each end of the perimeter section. If type is chord then the arc's region is defined by a section of the oval's perimeter plus a single line segment connecting the two end points of the perimeter section. If type is arc then the arc's region consists of a section of the perimeter alone. In this last case the -fill option is ignored.

#### 点地図品目 BITMAP ITEMS

点地図の型の品目は2つの色､前景色と背景の画像として画面に表示される。点地図は次の形式の部品命令によって生成される:　　　　 Items of type bitmap appear on the display as images with two colors, foreground and background. Bitmaps are created with widget commands of the following form:

    pathName create bitmap x y ?option value ...?
    pathName create bitmap coordList ?option value ...?

引数 x と y 又は coordList (それは二つの要素がなければならない)は画面上の点地図の配置に使われる座標を -anchor 指示項目によって制御される様に､指定する｡座標の後に option-value 対が幾つあっても好く､それぞれの組は品目に対する構成設定項目を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡点地図の品目は､マウス指示子がその囲み箱の部分のどこかに重なると､現在の品目になる｡　　　　 The arguments x and y or coordList (which must have two elements) specify the coordinates of a point used to position the bitmap on the display, as controlled by the -anchor option. After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. A bitmap item becomes the current item when the mouse pointer is over any part of its bounding box.

次の標準の指示項目が点地図に運用されている:　　　　 The following standard options are supported by bitmaps:

  -anchor | -state
  -tags

次の追加の指示項目が点地図に運用されている:　　　　 The following extra options are supported for bitmaps:

-background color

-activebackground color

-disabledbackground color
  通常､活性､無能状態の､それぞれの点地図の “0” 値の画素に使用する色を指定する｡ color はTk_GetColor によって受入れられるどの形式を有してもよい｡もしこの指示項目が指定されていないか､空文字列として指定されると画素が 0 のところは何も展示されない; これは透明の効果を生み出す｡　　　　 Specifies the color to use for each of the bitmap's “0” valued pixels in its normal, active and disabled states. Color may have any of the forms accepted by Tk_GetColor. If this option is not specified, or if it is specified as an empty string, then nothing is displayed where the bitmap pixels are 0; this produces a transparent effect.

-bitmap bitmap

-activebitmap bitmap

-disabledbitmap bitmap
  通常､活性､無能状態の､品目内に展示する点地図を指定する｡ bitmap は Tk_GetColor によって受入れられるどの形式を有してもよい｡　　　　 Specifies the bitmaps to display in the item in its normal, active and disabled states. Bitmap may have any of the forms accepted by Tk_GetBitmap.

-foreground color

-activeforeground color

-disabledforeground color
  通常､活性､無能状態の､それぞれの点地図の “1” 値の画素に使用する色を指定する｡ color は Tk_GetColor によって受入れられるどの形式を有してもよい｡　　　　 Specifies the color to use for each of the bitmap's “1” valued pixels in its normal, active and disabled states. Color may have any of the forms accepted by Tk_GetColor.

#### 影像品目 IMAGE ITEMS

影像型の品目は､画布上の画像を表示するために使用される。影像型は次の形式の部品命令によって生成される:　　　　 Items of type image are used to display images on a canvas. Images are created with widget commands of the following form:

    pathName create image x y ?option value ...?
    pathName create image coordList ?option value ...?

引数 x と y 又は coordList は画面上の影像の配置に使う座標を -anchor 指示項目をによって制御される様に指定する｡座標の後に幾つの option-value 対があってもよく､それぞれの組は品目に対する構成設定項目を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡影像の品目は､マウス指示子がその囲み箱のどこかの部分に重なると､現在の品目になる｡　　　　 The arguments x and y or coordList specify the coordinates of a point used to position the image on the display, as controlled by the -anchor option. After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. An image item becomes the current item when the mouse pointer is over any part of its bounding box.

次の標準の指示項目が影像に運用されている:　　　　 The following standard options are supported by images:

  -anchor | -state
  -tags

次の追加の指示項目が影像に運用されている:　　　　 The following extra options are supported for images:

-image name

-activeimage name

-disabledimage name
  通常､活性､無能状態の､品目内に展示する影像の名前を指定する｡この影像は予め image create 命令によって生成されたものでなければならない｡　　　　 Specifies the name of the images to display in the item in is normal, active and disabled states. This image must have been created previously with the image create command.

#### 線品目 LINE ITEMS

線の型の品目は､画布上の一つ或はそれ以上を接続した線分または曲線として画面に表示される｡線の品目は､ dchars と index と insert 部品命令を使用して､座標番号操作を運用している｡ 線は次の形式の部品命令によって生成される:　　　　 Items of type line appear on the display as one or more connected line segments or curves. Line items support coordinate indexing operations using the dchars, index and insert widget commands. Lines are created with widget commands of the following form:

    pathName create line x1 y1... xn yn ?option value ...?
    pathName create line coordList ?option value ...?

引数 x1 から yn 又は coordList は結合した線分の並びを記述している二つ或はそれ以上の点の座標を与える｡座標の後に幾つの option-value 対があってもよく､それぞれの組は品目に対する構成設定項目を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡線の品目は､マウス指示子が線のどこかの箇所に重なると何時でも､線が描かれるかどうか､滑らかであるか否かに拘らず､現在の品目になる｡　　　　 The arguments x1 through yn or coordList give the coordinates for a series of two or more points that describe a series of connected line segments. After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. A line item is the current item whenever the mouse pointer is over any segment of the line, whether drawn or not and whether or not the line is smoothed.

次の標準の指示項目が線に運用されている:　　　　 The following standard options are supported by lines:

  -dash | -activedash
  -disableddash | -dashoffset
  -fill | -activefill
  -disabledfill | -stipple
  -activestipple | -disabledstipple
  -state | -tags
  -width | -activewidth
  -disabledwidth

次の追加の指示項目が線に運用されている:　　　　 The following extra options are supported for lines:

-arrow where
  線の片方或は両方に鏃が描かれるか否かを指し示す｡where は none (鏃なし)か､ first (線の初めの点に鏃)､ last (線の終点に鏃)､ both (両端に鏃)の内のどれかでなければならない｡この指示項目の省略時設定は none である｡鏃を描くよう要求された時､ Tk は､描写された線が鏃の尖端ではなく鏃の首で終わる様に対応する線末端を内部で調整し､線が鏃端部を通り過ぎて拡張されない様にする｡これは､もしマウスがこの線の端部の上空を通過すると､Leave 行事を起動するかもしれない｡ 逆に鏃を取外すと､ Tk は裏表逆に対応する線端部を調整し､それが Enter 行事を起動するかもしれない｡　　　　 Indicates whether or not arrowheads are to be drawn at one or both ends of the line. Where must have one of the values none (for no arrowheads), first (for an arrowhead at the first point of the line), last (for an arrowhead at the last point of the line), or both (for arrowheads at both ends). This option defaults to none. When requested to draw an arrowhead, Tk internally adjusts the corresponding line end point so that the rendered line ends at the neck of the arrowhead rather than at its tip so that the line doesn't extend past the edge of the arrowhead. This may trigger a Leave event if the mouse is hovering this line end. Conversely, when removing an arrowhead Tk adjusts the corresponding line point the other way round, which may trigger an Enter event.

-arrowshape shape
  この指示項目は如何に鏃を描くかを指し示す｡ shape 引数は三つの要素のリストでなければならず､それぞれは上の COORDINATES 節に記述したどれかの形式で距離を指定する｡リストの第１要素は鏃の付根から尖端迄の線に沿った距離を与える｡第２要素は鏃の後端から尖端迄の線に沿った距離､第３要素は線の外側縁から鏃後端の点迄の距離を与える｡もしこの指示項目が指定されないと､ Tk は “尤もらしい” 形を採る｡(訳註第３要素は鏃後端と軸との垂直距離)　　　　 　 This option indicates how to draw arrowheads. The shape argument must be a list with three elements, each specifying a distance in any of the forms described in the COORDINATES section above. The first element of the list gives the distance along the line from the neck of the arrowhead to its tip. The second element gives the distance along the line from the trailing points of the arrowhead to the tip, and the third element gives the distance from the outside edge of the line to the trailing points. If this option is not specified then Tk picks a “reasonable” shape.

-capstyle style
  線の端末にどの脚を描くかを指定する｡style は Tk_GetCapStyle によって受入れられるどの形式を有していてもよい(butt (突合せ) か projecting (突出し) か round (丸め))｡もしこの指示項目が指定されないと､省略時設定の butt になる｡鏃が描かれる処では脚の型は無視される｡　　　　 Specifies the ways in which caps are to be drawn at the endpoints of the line. Style may have any of the forms accepted by Tk_GetCapStyle (butt, projecting, or round). If this option is not specified then it defaults to butt. Where arrowheads are drawn the cap style is ignored.

-joinstyle style
  接続部の頂点の箇所をどの様に描くかを指定する｡style は Tk_GetCapStyle によって受入れられるどの形式を有していてもよい(bevel (面取り) か miter (尖った) か round (丸め))｡もしこの指示項目が指定されないと､省略時設定の round になる｡もし､線が点を２つしか含まないとこの指示項目は不適切になる｡　　　　 Specifies the ways in which joints are to be drawn at the vertices of the line. Style may have any of the forms accepted by Tk_GetJoinStyle (bevel, miter, or round). If this option is not specified then it defaults to round. If the line only contains two points then this option is irrelevant.

-smooth smoothMethod
  smoothMethod は Tcl_GetBoolean に受入れられる形式の一つか又は線平滑化方法を有さねばならない｡Tk核芯では true と raw だけしか運用していないが( true の別名として bezier がある)､実行時に幾つか追加することができる｡もし論理偽値か空文字列が与えられると､平滑化は適用されない｡論理真値は true 平滑化と看做される｡もし､平滑化方法が true であると線は曲線として描くことになり､二次の雲形曲線の組として描写され: 第１と第２の線分について一つの雲形曲線が描かれ､第２と第３について次が続き､同様に継続する｡直線の線分は望ましい線分の終点を重複して曲線内部で生成することができる｡もし､平滑化方法が raw であると､次のことを指し示す､線はやはり曲線として描くべきであるが､ここでは座標のリストは次の通りである､最初の座標対(その後の全ての３つ目毎の座標対も)が三次ベジェ曲線の接合点であり､他の座標は三次ベジェ曲線の制御点である｡真直ぐな線分は制御点を隣の接合点に等しくさせ曲線内部で生成することが可能である｡もし､最後の点が制御点で且つ接合点でなければ､それが接合点になる様に点が(１回又は２回)繰返される｡ smoothMethod must have one of the forms accepted by Tcl_GetBoolean or a line smoothing method. Only true and raw are supported in the core (with bezier being an alias for true), but more can be added at runtime. If a boolean false value or empty string is given, no smoothing is applied. A boolean truth value assumes true smoothing. If the smoothing method is true, this indicates that the line should be drawn as a curve, rendered as a set of quadratic splines: one spline is drawn for the first and second line segments, one for the second and third, and so on. Straight-line segments can be generated within a curve by duplicating the end-points of the desired line segment. If the smoothing method is raw, this indicates that the line should also be drawn as a curve but where the list of coordinates is such that the first coordinate pair (and every third coordinate pair thereafter) is a knot point on a cubic Bezier curve, and the other coordinates are control points on the cubic Bezier curve. Straight line segments can be generated within a curve by making control points equal to their neighbouring knot points. If the last point is a control point and not a knot point, the point is repeated (one or two times) so that it also becomes a knot point.

-splinesteps number
  曲線に対して望ましい平滑の程度を指定する: それぞれの雲形曲線は近似的に number 個の線群になる｡この指示項目は -smooth 指示項目が真値か raw でない限り無視される｡　　　　 Specifies the degree of smoothness desired for curves: each spline will be approximated with number line segments. This option is ignored unless the -smooth option is true or raw.

#### 楕円品目 OVAL ITEMS

楕円の型の品目は､画布上の丸或は楕円の領域として画面に現れる｡それぞれの楕円は輪郭か､塗り潰しか､その両方かを保有してもよい｡楕円の型は次の形式の部品命令によって生成される:　　　　 Items of type oval appear as circular or oval regions on the display. Each oval may have an outline, a fill, or both. Ovals are created with widget commands of the following form:

    pathName create oval x1 y1 x2 y2 ?option value ...?
    pathName create oval coordList ?option value ...?

引数 x1 と y1 と x2 と y2 又は coordList は楕円を囲む矩形領域の対角方向に対峙する二つの隅の座標を与える｡この楕円は､矩形の上と左の縁を含み下と右の縁を含まない｡もしその領域が真四角であると結果として楕円は円になる; それ以外は引伸ばされた形になる｡座標の後に幾つの個数の option-value 対が続いてもよく､それぞれの組は品目に対する構成設定項目を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡もし､塗られているか､(完全に透明な時には) -fill と -outline 指示項目の両方が非空であれば塗られるべき箇所のどこかに､マウスの指示子が架かった時に､楕円品目は現在の品目になる｡　　　　 The arguments x1, y1, x2, and y2 or coordList give the coordinates of two diagonally opposite corners of a rectangular region enclosing the oval. The oval will include the top and left edges of the rectangle not the lower or right edges. If the region is square then the resulting oval is circular; otherwise it is elongated in shape. After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. An oval item becomes the current item when the mouse pointer is over any part that is painted or (when fully transparent) that would be painted if both the -fill and -outline options were non-empty.

次の標準の指示項目が楕円に運用されている:　　　　 The following standard options are supported by ovals:

  -dash | -activedash
  -disableddash | -dashoffset
  -fill | -activefill
  -disabledfill | -offset
  -outline | -activeoutline
  -disabledoutline | -outlineoffset
  -outlinestipple | -activeoutlinestipple
  -disabledoutlinestipple | -stipple
  -activestipple | -disabledstipple
  -state | -tags
  -width | -activewidth
  -disabledwidth

楕円固有の指示項目はない｡　　　　 There are no oval-specific options.

#### 多角形品目 POLYGON ITEMS

多角形の型の品目は､画布上の多角形又は曲線の塗りつぶし領域として画面に表示される｡多角形の品目は､ dchars と index と insert 画布部品命令を使用して､座標番号操作を運用している｡多角形は次の形式の部品命令によって生成される:　　　　 Items of type polygon appear as polygonal or curved filled regions on the display. Polygon items support coordinate indexing operations using the dchars, index and insert widget commands. Polygons are created with widget commands of the following form:

    pathName create polygon x1 y1 ... xn yn ?option value ...?
    pathName create polygon coordList ?option value ...?

引数 x1 から yn 迄､又は coordList (座標リスト)は多角形を定義する三つ或はそれ以上の点の座標を指定する｡形状を閉じる為に､最初の点を最後に繰り返さなくてもよい; Tk は自動的に最初と最後の間の周囲を閉じる｡座標の後に幾つかの option-value 対があるかも知れず､それぞれの対は品目に対する構成設定選択子を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡マウス指示子が多角形のどこかの箇所に重なると何時でも､輪郭が描かれているかどうか､滑らかであるか否かに拘らず､多角形の品目が､現在の品目になる｡　　　　 　 The arguments x1 through yn or coordList specify the coordinates for three or more points that define a polygon. The first point should not be repeated as the last to close the shape; Tk will automatically close the periphery between the first and last points. After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. A polygon item is the current item whenever the mouse pointer is over any part of the polygon, whether drawn or not and whether or not the outline is smoothed.

次の標準の指示項目が多角形に運用されている:　　　　 The following standard options are supported by polygons:

  -dash | -activedash
  -disableddash | -dashoffset
  -fill | -activefill
  -disabledfill | -offset
  -outline | -activeoutline
  -disabledoutline | -outlineoffset
  -outlinestipple | -activeoutlinestipple
  -disabledoutlinestipple | -stipple
  -activestipple | -disabledstipple
  -state | -tags
  -width | -activewidth
  -disabledwidth

次の追加の指示項目が多角形に運用されている:　　　　 The following extra options are supported for polygons:

-joinstyle style
  接続部の頂点の箇所をどの様に描くかを指定する｡ style は Tk_GetCapStyle によって受入れられるどの形式を有していてもよい(bevel (面取り) か miter (尖った) か round (丸め))｡もしこの指示項目が指定されないと､省略時設定の round になる｡　　　　 Specifies the ways in which joints are to be drawn at the vertices of the outline. Style may have any of the forms accepted by Tk_GetJoinStyle (bevel, miter, or round). If this option is not specified then it defaults to round.

-smooth boolean
  boolean は Tcl_GetBoolean に受入れられる形式の一つか又は線平滑化方法を有さねばならない｡Tk核芯では true と raw だけしか運用していないが( true の別名として bezier がある)､実行時に幾つか追加することができる｡もし論理偽値か空文字列が与えられると､平滑化は適用されない｡論理真値は平滑化が true と看做される｡もし､平滑化方法が true であると多角形は曲線として描かれ､二次の雲形曲線の組として描写される: 第１と第２の線分として一つの雲形曲線が描かれ､第２と第３の線分として次が続き､同様に継続する｡曲線内部に直線の線分を生成するには､望ましい線分の終点を重複することで可能である｡もし､平滑化方法が raw であると､次のことを指し示す､線はやはり曲線として描くべきであるが､ここでは座標のリストは次の通りである､最初の座標対(その後の全ての３つ目毎の座標対も)が三次ベジェ曲線の接合点であり､それ以外の座標は三次ベジェ曲線の制御点である｡曲線内部に､真直ぐな線分を生成するには､制御点を隣の接合点に等しくすることにより可能である｡もし､最後の点が制御点対の第２点でなければ､それが制御点対の第２点になる様に(結合している接続点は第１制御点になる様に)､点が(１回又は２回)繰返される｡ Boolean must have one of the forms accepted by Tcl_GetBoolean or a line smoothing method. Only true and raw are supported in the core (with bezier being an alias for true), but more can be added at runtime. If a boolean false value or empty string is given, no smoothing is applied. A boolean truth value assumes true smoothing. If the smoothing method is true, this indicates that the polygon should be drawn as a curve, rendered as a set of quadratic splines: one spline is drawn for the first and second line segments, one for the second and third, and so on. Straight-line segments can be generated within a curve by duplicating the end-points of the desired line segment. If the smoothing method is raw, this indicates that the polygon should also be drawn as a curve but where the list of coordinates is such that the first coordinate pair (and every third coordinate pair thereafter) is a knot point on a cubic Bezier curve, and the other coordinates are control points on the cubic Bezier curve. Straight line segments can be generated within a curve by making control points equal to their neighbouring knot points. If the last point is not the second point of a pair of control points, the point is repeated (one or two times) so that it also becomes the second point of a pair of control points (the associated knot point will be the first control point).

-splinesteps number
  曲線に対して望ましい平滑の程度を指定する: それぞれの雲形曲線は number 個の線分により近似される｡この指示項目は -smooth 指示項目が真値か raw でない限り無視される｡　　　　 Specifies the degree of smoothness desired for curves: each spline will be approximated with number line segments. This option is ignored unless the -smooth option is true or raw.

多角形品目は他の､矩形､楕円､円弧のような品目とは､内側の点が､たとえ其処が塗り潰されてなくても､多角形の “内部” と看做される(譬えば､ find closest や find overlapping 部品命令の為に)点で異なっている｡大多数の他の品目の型については､内側の点は品目が塗り潰された時にのみ内部にあると看做すか､塗り潰しも外側もないかである｡もし塗り潰してない多角形の内側の点が多角形の内部であると看做さないことを望むなら代りに線の品目を使うべきである｡　　　　 Polygon items are different from other items such as rectangles, ovals and arcs in that interior points are considered to be “inside” a polygon (e.g. for purposes of the find closest and find overlapping widget commands) even if it is not filled. For most other item types, an interior point is considered to be inside the item only if the item is filled or if it has neither a fill nor an outline. If you would like an unfilled polygon whose interior points are not considered to be inside the polygon, use a line item instead.

#### 矩形品目 RECTANGLE ITEMS

矩形の型の品目は､画布上の矩形の領域として画面に表示される｡それぞれの矩形は輪郭､塗り潰し､又はその両方を有するかもしれない｡矩形は次の形式の部品命令によって生成される:　　　　 Items of type rectangle appear as rectangular regions on the display. Each rectangle may have an outline, a fill, or both. Rectangles are created with widget commands of the following form:

    pathName create rectangle x1 y1 x2 y2 ?option value ...?
    pathName create rectangle coordList ?option value ...?

引数 x1 と y1 と x2 と y2 又は coordList (それは四つの要素を有さねばならない)は矩形領域の対角方向に反対の隅の二つの座標を与える(矩形は上と左の縁を含み下と右の縁を含まない)｡座標の後に幾つかの option-value 対があるかも知れず､それぞれの対は品目に対する構成設定選択子を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡もし､塗られているか､(完全に透明な時には) -fill と -outline 指示項目の両方が非空であれば塗られるべき箇所のどこかに､マウスの指示子が架かった時に､矩形品目は現在の品目になる｡　　　　 The arguments x1, y1, x2, and y2 or coordList (which must have four elements) give the coordinates of two diagonally opposite corners of the rectangle (the rectangle will include its upper and left edges but not its lower or right edges). After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. A rectangle item becomes the current item when the mouse pointer is over any part that is painted or (when fully transparent) that would be painted if both the -fill and -outline options were non-empty.

次の標準の指示項目が矩形に運用されている:　　　　 The following standard options are supported by rectangles:

  -dash | -activedash
  -disableddash | -dashoffset
  -fill | -activefill
  -disabledfill | -offset
  -outline | -activeoutline
  -disabledoutline | -outlineoffset
  -outlinestipple | -activeoutlinestipple
  -disabledoutlinestipple | -stipple
  -activestipple | -disabledstipple
  -state | -tags
  -width | -activewidth
  -disabledwidth

矩形固有の指示項目はない｡　　　　 There are no rectangle-specific options.

#### 文書品目 TEXT ITEMS

文書の型の品目は､文字の文字列を画面に一乃至多数行に表示する｡文書の品目は､位置づけと､校正と､選択を､ dchars 部品命令､ focus 部品命令､ icursor 部品命令､ index 部品命令､ insert 部品命令､ select 部品命令を通して運用している｡文書品目は次の形式の部品命令によって生成される:　　　　 　 A text item displays a string of characters on the screen in one or more lines. Text items support indexing, editing and selection through the dchars widget command, the focus widget command, the icursor widget command, the index widget command, the insert widget command, and the select widget command. Text items are created with widget commands of the following form:

    pathName create text x y ?option value ...?
    pathName create text coordList ?option value ...?

引数 x と y 又は coordList (これには二つの要素がなければならない)は表示上の文書の配置に使われる座標を指定する(文書が如何に展示されるかの更なる情報については下の指示項目を参照されたい)｡座標の後に幾つの個数の option-value 対が続いてもよく､それぞれは品目に対する構成設定指示項目を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡文書の品目は､マウス指示子がその囲み箱のどの部分かに重なると､現在の品目になる｡　　　　 The arguments x and y or coordList (which must have two elements) specify the coordinates of a point used to position the text on the display (see the options below for more information on how text is displayed). After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. A text item becomes the current item when the mouse pointer is over any part of its bounding box.

次の標準の指示項目が文書に運用されている:　　　　 　 The following standard options are supported by text items:

  -anchor | -fill
  -activefill | -disabledfill
  -stipple | -activestipple
  -disabledstipple | -state
  -tags

次の追加の指示項目が文書に運用されている:　　　　 　 The following extra options are supported for text items:

-angle rotationDegrees
  rotationDegrees は文書の位置取りについて文書を反時計回りにどの程度回転するかを告げる; それは 0.0 から 360.0 迄のどの浮動小数も有し得る｡譬えば､ rotationDegrees が 90 の場合､文書は底から頂へ描かれる｡この指示項目の省略時設定は 0.0 である｡ RotationDegrees tells how many degrees to rotate the text anticlockwise about the positioning point for the text; it may have any floating-point value from 0.0 to 360.0. For example, if rotationDegrees is 90, then the text will be drawn vertically from bottom to top. This option defaults to 0.0.

-font fontName
  文書品目に使用する文字形状を指定する｡ fontName は Tk_GetFont に受入れられるどの様な文字列でもよい｡もしこの指示項目が指定されないと､省略時設定は系依存の文字形状である｡　　　　 Specifies the font to use for the text item. FontName may be any string acceptable to Tk_GetFont. If this option is not specified, it defaults to a system-dependent font.

-justify how
  束縛されている領域で､文書をどのように整列するかを指定する｡ how は left か right か center のいずれかでなければならない｡この指示項目は文書を複数行として展示するときのみ有効である｡この指示項目が省略されると､その省略時設定は left である｡　　　　 Specifies how to justify the text within its bounding region. How must be one of the values left, right, or center. This option will only matter if the text is displayed as multiple lines. If the option is omitted, it defaults to left.

-text string
  string は文書の品目中に展示される文字を指定する｡改行文字は行の分割を引起す｡品目中の文字は insert と delete 部品命令によって変化するかもしれない｡この指示項目の省略時設定は空文字列である｡ String specifies the characters to be displayed in the text item. Newline characters cause line breaks. The characters in the item may also be changed with the insert and delete widget commands. This option defaults to an empty string.

-underline
  文書の中の下線を引かれるべき文字の位置を整数で指定する｡ 0 は展示された文書の初めの文字に対応し､ 1 は次の文字に､同様に続く｡ -1 はどこにも下線を引かないことを意味する(もし､文書品目全体に下線を引く場合､代りに適切な文字形状を使用すべき)｡　　　　 　 Specifies the integer index of a character within the text to be underlined. 0 corresponds to the first character of the text displayed, 1 to the next character, and so on. -1 means that no underline should be drawn (if the whole text item is to be underlined, the appropriate font should be used instead).

-width lineLength
  文書に関する最大の行長を指定する､上の COORDINATES 内に記述されているどの形式でもよい｡もしこの指示項目が零(省略時設定)であると､その文書は改行文字のみで分割される｡しかし､もしこの指示項目が非零であると､ lineLength より長いどの行も､行を lineLength より短くする空白の前で分割される; 空白文字が恰も改行文字の如く取り扱われる｡　　　　 Specifies a maximum line length for the text, in any of the forms described in the COORDINATES section above. If this option is zero (the default) the text is broken into lines only at newline characters. However, if this option is non-zero then any line that would be longer than lineLength is broken just before a space character to make the line shorter than lineLength; the space character is treated as if it were a newline character.

#### 窓の品目 WINDOW ITEMS

窓の型の品目は､特定の窓が画布内の与えられた位置に展示されることを引起す｡窓品目は次の形式の部品命令によって生成される:　　　　 Items of type window cause a particular window to be displayed at a given position on the canvas. Window items are created with widget commands of the following form:

    pathName create window x y ?option value ...?
    pathName create window coordList ?option value ...?

引数 x と y 又は coordList (後者は二つの要素を有さねばならない)は画面上の窓の配置に使う座標を -anchor 指示項目により制御された様に指定する｡座標の後に幾つの個数の option-value 対が続いてもよく､それぞれの組は品目に対する構成設定項目を設定する｡これらの同じ option-value 対は itemconfigure 部品命令内で品目の構成設定を変更する為に使用され得る｡理論的には窓の品目は､マウス指示子がその囲み箱のどこかの部分に重なると､現在の品目になる､しかし実際はこれは典型的には生じない､理由はマウス指示子はその位置で画布に重なることを止めるため｡　　　　 The arguments x and y or coordList (which must have two elements) specify the coordinates of a point used to position the window on the display, as controlled by the -anchor option. After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. Theoretically, a window item becomes the current item when the mouse pointer is over any part of its bounding box, but in practice this typically does not happen because the mouse pointer ceases to be over the canvas at that point.

次の標準の指示項目が窓に運用されている:　　　　 The following standard options are supported by window items:

  -anchor | -state
  -tags

次の追加の指示項目が窓品目に運用されている:　　　　 The following extra options are supported for window items:

-height pixels
  品目の窓に代入される高さを指定する｡ pixels は上の COORDINATES 節内に記述されたどの形式でも有し得る｡もし､この指示項目が指定されないか､零に指定されると窓は何であれ内部的に要求された高さが与えられる｡　　　　 Specifies the height to assign to the item's window. Pixels may have any of the forms described in the COORDINATES section above. If this option is not specified, or if it is specified as zero, then the window is given whatever height it requests internally.

-width pixels
  品目の窓に代入される幅を指定する｡ pixels は上の COORDINATES 節内に記述されたどの形式でも有し得る｡もし､この指示項目が指定されないか､零に指定されると窓は何であれ内部的に要求された幅が与えられる｡　　　　 Specifies the width to assign to the item's window. Pixels may have any of the forms described in the COORDINATES section above. If this option is not specified, or if it is specified as zero, then the window is given whatever width it requests internally.

-window pathName
  この品目に結合している窓を指定する｡ pathName によって指定された窓は画布の子供か､画布の部品の何かの祖先の子供でなくてはならない｡ pathName は頂上水準窓を参照してはならない｡　　　　 Specifies the window to associate with this item. The window specified by pathName must either be a child of the canvas widget or a child of some ancestor of the canvas widget. PathName may not refer to a top-level window.

註意: 窓が管理されている方法の制約のために､窓の項目の上に他の図形的な品目(譬えば､線や影像など)を描画することはできない｡窓の品目は展示リストの順序に関係なく､どの図形に重なっても覆い隠す｡又更に註意すべきは､窓品目は､他の画布品目とは異なり､それらを含んでいる画布の枠で切取りされず表示され､代わりに -window 指示項目で指定された窓の親の部品によって切り取られることに注意されたい; 親部品が画布である場合､窓品目は画布の縁に重ねることができることを意味する｡　　　　 Note: due to restrictions in the ways that windows are managed, it is not possible to draw other graphical items (such as lines and images) on top of window items. A window item always obscures any graphics that overlap it, regardless of their order in the display list. Also note that window items, unlike other canvas items, are not clipped for display by their containing canvas's border, and are instead clipped by the parent widget of the window specified by the -window option; when the parent widget is the canvas, this means that the window item can overlap the canvas's border.

### 応用譜定義の品目の型 APPLICATION-DEFINED ITEM TYPES

個別の応用譜に関して画布の部品の為の新しい品目の型を C の命令符号を使って定義することは可能である｡ Tk_CreateItemType に関する文書説明書を参照されたい｡　　　　 It is possible for individual applications to define new item types for canvas widgets using C code. See the documentation for Tk_CreateItemType.

### 束縛 BINDINGS

現在の実装では､新しい画布はなにも省略時設定の振舞いが与えられていない: 画布にその振舞いを与えるには､明示的にTcl 命令を実行する必要がある｡　　　　 In the current implementation, new canvases are not given any default behavior: you will have to execute explicit Tcl commands to give the canvas its behavior.

### 著作権表示 CREDITS

Tk の画布部品は Joel Bartlett 氏の ezd 算譜の着想からの恥知らずな盗作である｡ ezd は函数型言語の Scheme の環境下で画布よりも１から２年先行して構造的描画を提供した｡図形対象の配置と動画に関するその簡明な仕組みは画布の機能に霊感を与えた｡　　　　 Tk's canvas widget is a blatant ripoff of ideas from Joel Bartlett's ezd program. Ezd provides structured graphics in a Scheme environment and preceded canvases by a year or two. Its simple mechanisms for placing and animating graphical objects inspired the functions of canvases.

### SEE ALSO

bind, font, image, scrollbar

### KEYWORDS

canvas, widget
Copyright © 1992-1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 1997-1999 Scriptics Corporation.