1mNAME0m
       canvas - Create and manipulate canvas widgets

1mSYNOPSIS0m
       1mcanvas 4m22mpathName24m ?4moptions24m?

1mSTANDARD OPTIONS0m
       1m-background           -insertborderwidth   -selectborderwidth0m
       1m-borderwidth          -insertofftime       -selectforeground0m
       1m-cursor               -insertontime        -takefocus0m
       1m-highlightbackground  -insertwidth         -xscrollcommand0m
       1m-highlightcolor       -relief              -yscrollcommand0m
       1m-highlightthickness   -state0m
       1m-insertbackground     -selectbackground0m

       See the 1moptions 22mmanual entry for details on the standard options.

1mWIDGET-SPECIFIC OPTIONS0m
       Command-Line Name:1m-closeenough0m
       Database Name:  1mcloseEnough0m
       Database Class: 1mCloseEnough0m

              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:1m-confine0m
       Database Name:  1mconfine0m
       Database Class: 1mConfine0m

              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 1mscrollRegion 22margument.  Defaults to true, which
              means that the  view  will  be  constrained  within  the  scroll
              region.

       Command-Line Name:1m-height0m
       Database Name:  1mheight0m
       Database Class: 1mHeight0m

              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 1mCOORDINATES 22msection below.

       Command-Line Name:1m-scrollregion0m
       Database Name:  1mscrollRegion0m
       Database Class: 1mScrollRegion0m

              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
              1mCOORDINATES 22msection below.

       Command-Line Name:1m-state0m
       Database Name:  1mstate0m
       Database Class: 1mState0m

              Modifies  the default state of the canvas where 4mstate24m may be set
              to one  of:  1mnormal22m,  1mdisabled22m,  or  1mhidden22m.  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 differ-
              ent situations. The options that start with 1mactive  22mcontrol  the
              appearence  when  the mouse pointer is over it, while the option
              starting with 1mdisabled 22mcontrols the appearence when the state is
              disabled.   Canvas  items  which  are 1mdisabled 22mwill not react to
              canvas bindings.

       Command-Line Name:1m-width0m
       Database Name:  1mwidth0m
       Database Class: 1mwidth0m

              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 1mCOORDINATES 22msection  below.

       Command-Line Name:1m-xscrollincrement0m
       Database Name:  1mxScrollIncrement0m
       Database Class: 1mScrollIncrement0m

              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
              1mxScrollIncrement22m;  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 1mxScrollIncrement22m.  If  the  value  of
              this  option  is  less  than  or  equal to zero, then horizontal
              scrolling is unconstrained.

       Command-Line Name:1m-yscrollincrement0m
       Database Name:  1myScrollIncrement0m
       Database Class: 1mScrollIncrement0m

              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  win-
              dow  will  be constrained so that the canvas y coordinate at the
              top  edge  of  the  window  is  always  an  even   multiple   of
              1myScrollIncrement22m;   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 1myScrollIncrement22m.  If the value of
              this option is  less  than  or  equal  to  zero,  then  vertical
              scrolling is unconstrained.


1mINTRODUCTION0m
       The  1mcanvas  22mcommand  creates a new window (given by the 4mpathName24m argu-
       ment) 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  1mcanvas  22mcommand  returns  its 4mpathName24m argument.  At the time this
       command is invoked, there must not exist a window named  4mpathName24m,  but
       4mpathName24m's parent must exist.

       Canvas  widgets  implement  structured graphics.  A canvas displays any
       number of 4mitems24m, which may be things like rectangles,  circles,  lines,
       and text.  Items may be manipulated (e.g. moved or re-colored) and com-
       mands may be associated with items in much the same way that  the  1mbind0m
       command allows commands to be bound to widgets.  For example, a partic-
       ular 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.

1mDISPLAY LIST0m
       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  every-
       thing else.  Widget commands may be used to re-arrange the order of the
       display list.

       Window items are an exception to the above rules.  The underlying  win-
       dow  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 1mraise 22mand 1mlower 22mTk com-
       mands instead.

1mITEM IDS AND TAGS0m
       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.

       Each  item  may also have any number of 4mtags24m 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'' isn't.  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''.

       The tag 1mall 22mis implicitly associated with every item in the canvas;  it
       may be used to invoke operations on all the items in the canvas.

       The  tag 1mcurrent 22mis managed automatically by Tk; it applies to the 4mcur-0m
       4mrent24m 4mitem24m, which is the topmost item whose drawn area covers the  posi-
       tion  of the mouse cursor.  If the mouse is not in the canvas widget or
       is not over an item, then no item has the 1mcurrent 22mtag.

       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 4mtagOrId24m 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.

       4mtagOrId24m 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}
       will find only those items with either "a" or "b" tags, but not both.

       Some  widget  commands  only  operate  on  a single item at a time;  if
       4mtagOrId24m is specified in a way that names multiple items, then the  nor-
       mal  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.

1mCOORDINATES0m
       All  coordinates  related to canvases are stored as floating-point num-
       bers.  Coordinates and distances are specified in screen  units,  which
       are  floating-point  numbers optionally followed by one of several let-
       ters.  If no letter is supplied then the distance is in pixels.  If the
       letter  is  1mm 22mthen the distance is in millimeters on the screen;  if it
       is 1mc 22mthen the distance is in centimeters; 1mi 22mmeans inches, and  1mp  22mmeans
       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.

1mTRANSFORMATIONS0m
       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 ori-
       gin of the window using the 1mxview 22mand 1myview 22mwidget commands;   this  is
       typically used for scrolling.  Canvases do not support scaling or rota-
       tion 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.

       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  1mcanvasx0m
       and  1mcanvasy  22mwidget  commands  if you adjust the origin of the visible
       area.  However, this also means that any focus ring (as  controlled  by
       the 1m-highlightthickness 22moption) and window border (as controlled by the
       1m-borderwidth 22moption) must be taken into account before you get  to  the
       visible area of the canvas.

1mINDICES0m
       Text  items  support  the notion of an 4mindex24m for identifying particular
       positions within the item.  In a  similar  fashion,  line  and  polygon
       items  support 4mindex24m 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 inser-
       tion 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 advis-
       able 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 don't support the insertion cursor
       and the selection. Their  indices  are  supposed  to  be  even  always,
       because coordinates always appear in pairs.

       4mnumber24m    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 poly-
                 gons, numbers less than 0 or greater then 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.

       1mend       22mRefers to the character or coordinate just after the last one
                 in the item (same as the number of characters or  coordinates
                 in the item).

       1minsert    22mRefers  to the character just before which the insertion cur-
                 sor is drawn in this item. Not valid for lines and  polygons.

       1msel.first 22mRefers  to  the first selected character in the item.  If the
                 selection isn't in this item then this form is illegal.

       1msel.last  22mRefers to the last selected character in the  item.   If  the
                 selection isn't in this item then this form is illegal.

       1m@4m22mx,y24m      Refers to the character or coordinate at the point given by 4mx0m
                 and 4my24m, where 4mx24m and 4my24m are specified in the  coordinate  system
                 of  the  canvas.  If 4mx24m and 4my24m lie outside the coordinates cov-
                 ered by the text item, then they refer to the first  or  last
                 character in the line that is closest to the given point.

1mDASH PATTERNS0m
       Many items support the notion of a dash pattern for outlines.

       The  first  possible  syntax is a list of integers. Each element repre-
       sents the number of pixels of a line segment. Only the odd segments are
       drawn using the "outline" color. The other segments are drawn transpar-
       ent.

       The second possible syntax is a character list containing only 5 possi-
       ble  characters  1m[.,-_  ]22m.  The  space can be used to enlarge the space
       between other line elements, and can not 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.

       On  systems which support only a limited set of dash patterns, the dash
       pattern will be displayed as the closest dash pattern  that  is  avail-
       able.   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.

1mWIDGET COMMAND0m
       The  1mcanvas  22mcommand  creates a new Tcl command whose name is 4mpathName24m.
       This command may be used to invoke various operations  on  the  widget.
       It has the following general form:
              4mpathName24m 4moption24m ?4marg24m 4marg24m 4m...24m?
       4mOption24m  and  the 4marg24ms determine the exact behavior of the command.  The
       following widget commands are possible for canvas widgets:

       4mpathName24m 1maddtag 4m22mtag24m 4msearchSpec24m ?4marg24m 4marg24m 4m...24m?
              For each item that meets the constraints specified by 4msearchSpec0m
              and  the  4marg24ms,  add 4mtag24m to the list of tags associated with the
              item if it isn't already present on that list.  It  is  possible
              that  no  items will satisfy the constraints given by 4msearchSpec0m
              and 4marg24ms, in which case the command has no effect.  This command
              returns  an  empty  string  as result.  4mSearchSpec24m and 4marg24m's may
              take any of the following forms:

              1mabove 4m22mtagOrId0m
                     Selects the item just after  (above)  the  one  given  by
                     4mtagOrId24m  in  the  display  list.  If 4mtagOrId24m denotes more
                     than one item, then the last (topmost) of these items  in
                     the display list is used.

              1mall    22mSelects all the items in the canvas.

              1mbelow 4m22mtagOrId0m
                     Selects  the  item  just  before (below) the one given by
                     4mtagOrId24m in the display list.   If  4mtagOrId24m  denotes  more
                     than  one item, then the first (lowest) of these items in
                     the display list is used.

              1mclosest 4m22mx24m 4my24m ?4mhalo24m? ?4mstart24m?
                     Selects the item closest to the point given by 4mx24m  and  4my24m.
                     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 4mhalo24m is specified, then  it  must  be  a  non-negative
                     value.  Any item closer than 4mhalo24m to the point is consid-
                     ered to overlap it.  The 4mstart24m argument may  be  used  to
                     step  circularly through all the closest items.  If 4mstart0m
                     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 4mstart24m in the display  list;   if  no  such  item
                     exists,  then the selection behaves as if the 4mstart24m argu-
                     ment had not been specified.

              1menclosed 4m22mx124m 4my124m 4mx224m 4my20m
                     Selects all the  items  completely  enclosed  within  the
                     rectangular  region given by 4mx124m, 4my124m, 4mx224m, and 4my224m.  4mX124m must
                     be no greater then 4mx224m and 4my124m must be no greater than  4my224m.

              1moverlapping 4m22mx124m 4my124m 4mx224m 4my20m
                     Selects all the items that overlap or are enclosed within
                     the rectangular region given by 4mx124m, 4my124m, 4mx224m, and  4my224m.   4mX10m
                     must be no greater then 4mx224m and 4my124m must be no greater than
                     4my224m.

              1mwithtag 4m22mtagOrId0m
                     Selects all the items given by 4mtagOrId24m.

       4mpathName24m 1mbbox 4m22mtagOrId24m ?4mtagOrId24m 4mtagOrId24m 4m...24m?
              Returns a list with four elements giving an approximate bounding
              box  for all the items named by the 4mtagOrId24m arguments.  The list
              has the form ``4mx124m 4my124m 4mx224m 4my224m'' such that the drawn  areas  of  all
              the  named  elements  are within the region bounded by 4mx124m on the
              left, 4mx224m on the right, 4my124m on the top, and 4my224m on the bottom.  The
              return  value  may overestimate the actual bounding box by a few
              pixels.  If no items match any of the 4mtagOrId24m  arguments  or  if
              the  matching  items  have  empty bounding boxes (i.e. they have
              nothing to display) then an empty string is returned.

       4mpathName24m 1mbind 4m22mtagOrId24m ?4msequence24m? ?4mcommand24m?
              This command associates 4mcommand24m with  all  the  items  given  by
              4mtagOrId24m  such that whenever the event sequence given by 4msequence0m
              occurs for one of the items the command will be  invoked.   This
              widget  command  is  similar  to the 1mbind 22mcommand except that it
              operates on items in a canvas rather than entire  widgets.   See
              the  1mbind  22mmanual  entry  for  complete details on the syntax of
              4msequence24m and  the  substitutions  performed  on  4mcommand24m  before
              invoking  it.  If all arguments are specified then a new binding
              is created, replacing any existing binding for the same 4msequence0m
              and  4mtagOrId24m  (if  the  first character of 4mcommand24m is ``+'' then
              4mcommand24m augments an existing binding rather than replacing  it).
              In this case the return value is an empty string.  If 4mcommand24m is
              omitted then the command returns  the  4mcommand24m  associated  with
              4mtagOrId24m  and 4msequence24m (an error occurs if there is no such bind-
              ing).  If both 4mcommand24m and 4msequence24m are omitted then the command
              returns a list of all the sequences for which bindings have been
              defined for 4mtagOrId24m.

              The only events for which bindings may be  specified  are  those
              related to the mouse and keyboard (such as 1mEnter22m, 1mLeave22m, 1mButton-0m
              1mPress22m, 1mMotion22m, and 1mKeyPress22m) or virtual events.  The handling of
              events in canvases uses the current item defined in ITEM IDS AND
              TAGS above.  1mEnter 22mand 1mLeave 22mevents trigger for an item when  it
              becomes  the current item or ceases to be the current item; note
              that these events are different than 1mEnter 22mand 1mLeave 22mevents  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 1mfocus 22mwidget command below for more on this).
              If a virtual event is used in a binding, that binding can  trig-
              ger only if the virtual event is defined by an underlying mouse-
              related or keyboard-related event.

              It is possible for  multiple  bindings  to  match  a  particular
              event.  This could occur, for example, if one binding is associ-
              ated 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 1mall 22mtag  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 1mcontinue 22mcommand  in  a
              binding  script terminates that script, and a 1mbreak 22mcommand ter-
              minates that script and skips  any  remaining  scripts  for  the
              event, just as for the 1mbind 22mcommand.

              If bindings have been created for a canvas window using the 1mbind0m
              command, then they are invoked in addition to  bindings  created
              for the canvas's items using the 1mbind 22mwidget command.  The bind-
              ings for items will be invoked before any of  the  bindings  for
              the window as a whole.

       4mpathName24m 1mcanvasx 4m22mscreenx24m ?4mgridspacing24m?
              Given  a window x-coordinate in the canvas 4mscreenx24m, this command
              returns the canvas x-coordinate that is displayed at that  loca-
              tion.   If  4mgridspacing24m is specified, then the canvas coordinate
              is rounded to the nearest multiple of 4mgridspacing24m units.

       4mpathName24m 1mcanvasy 4m22mscreeny24m ?4mgridspacing24m?
              Given a window y-coordinate in the canvas 4mscreeny24m  this  command
              returns  the canvas y-coordinate that is displayed at that loca-
              tion.  If 4mgridspacing24m is specified, then the  canvas  coordinate
              is rounded to the nearest multiple of 4mgridspacing24m units.

       4mpathName24m 1mcget 4m22moption0m
              Returns  the  current value of the configuration option given by
              4moption24m.  4mOption24m may have any of the values accepted by the  1mcan-0m
              1mvas 22mcommand.

       4mpathName24m 1mconfigure ?4m22moption24m? ?4mvalue24m? ?4moption24m 4mvalue24m 4m...24m?
              Query  or modify the configuration options of the widget.  If no
              4moption24m is specified, returns a list describing all of the avail-
              able  options for 4mpathName24m (see 1mTk_ConfigureInfo 22mfor information
              on the format of this list).  If 4moption24m  is  specified  with  no
              4mvalue24m,  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 4moption24m is specified).  If one or
              more 4moption-value24m 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.  4mOption24m may  have  any
              of the values accepted by the 1mcanvas 22mcommand.

       4mpathName24m 1mcoords 4m22mtagOrId24m ?4mx024m 4my024m 4m...24m?

       4mpathName24m 1mcoords 4m22mtagOrId24m ?4mcoordList24m?
              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 4mtagOrId24m.  If
              coordinates are specified, then they replace the current coordi-
              nates  for the named item.  If 4mtagOrId24m refers to multiple items,
              then the first one in the display list is used.

       4mpathName24m 1mcreate 4m22mtype24m 4mx24m 4my24m ?4mx24m 4my24m 4m...24m? ?4moption24m 4mvalue24m 4m...24m?

       4mpathName24m 1mcreate 4m22mtype24m 4mcoordList24m ?4moption24m 4mvalue24m 4m...24m?
              Create a new item in 4mpathName24m of type 4mtype24m.  The exact format of
              the  arguments after 1mtype 22mdepends on 1mtype22m, but usually they con-
              sist of the coordinates for one  or  more  points,  followed  by
              specifications  for  zero or more item options.  See the subsec-
              tions on individual item types below for more on the  syntax  of
              this command.  This command returns the id for the new item.

       4mpathName24m 1mdchars 4m22mtagOrId24m 4mfirst24m ?4mlast24m?
              For  each item given by 4mtagOrId24m, delete the characters, or coor-
              dinates, in the range given by 4mfirst24m and  4mlast24m,  inclusive.   If
              some of the items given by 4mtagOrId24m don't support indexing opera-
              tions then they ignore dchars.  Text items interpret  4mfirst24m  and
              4mlast24m as indices to a character, line and polygon items interpret
              them indices  to  a  coordinate  (an  x,y  pair).   Indices  are
              described  in INDICES above.  If 4mlast24m is omitted, it defaults to
              4mfirst24m.  This command returns an empty string.

       4mpathName24m 1mdelete 22m?4mtagOrId24m 4mtagOrId24m 4m...24m?
              Delete each of the items given by each 4mtagOrId24m,  and  return  an
              empty string.

       4mpathName24m 1mdtag 4m22mtagOrId24m ?4mtagToDelete24m?
              For  each of the items given by 4mtagOrId24m, delete the tag given by
              4mtagToDelete24m from the list of those associated with the item.  If
              an  item doesn't have the tag 4mtagToDelete24m then the item is unaf-
              fected by the  command.   If  4mtagToDelete24m  is  omitted  then  it
              defaults to 4mtagOrId24m.  This command returns an empty string.

       4mpathName24m 1mfind 4m22msearchCommand24m ?4marg24m 4marg24m 4m...24m?
              This  command  returns  a  list consisting of all the items that
              meet the  constraints  specified  by  4msearchCommand24m  and  4marg24m's.
              4mSearchCommand24m  and  4margs24m  have  any of the forms accepted by the
              1maddtag 22mcommand.  The items are returned in stacking order,  with
              the lowest item first.

       4mpathName24m 1mfocus 22m?4mtagOrId24m?
              Set  the  keyboard focus for the canvas widget to the item given
              by 4mtagOrId24m.  If 4mtagOrId24m refers to several items, then the  focus
              is  set to the first such item in the display list that supports
              the insertion cursor.  If 4mtagOrId24m doesn't refer to any items, or
              if  none  of  them  support the insertion cursor, then the focus
              isn't changed.  If 4mtagOrId24m is an empty string,  then  the  focus
              item  is reset so that no item has the focus.  If 4mtagOrId24m is not
              specified then the command returns the id for the item that cur-
              rently  has  the  focus,  or  an empty string if no item has the
              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 1mfocus 22mcommand) are totally indepen-
              dent: a given item doesn't 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 1mfocus 22mwidget command with the 1mfocus 22mcommand to set the focus
              window to the canvas (if it wasn't there already).

       4mpathName24m 1mgettags 4m22mtagOrId0m
              Return a list whose elements are the tags  associated  with  the
              item given by 4mtagOrId24m.  If 4mtagOrId24m refers to more than one item,
              then the tags are returned from the first such item in the  dis-
              play  list.   If  4mtagOrId24m  doesn't refer to any items, or if the
              item contains no tags, then an empty string is returned.

       4mpathName24m 1micursor 4m22mtagOrId24m 4mindex0m
              Set the position of the insertion cursor for the  item(s)  given
              by  4mtagOrId24m to just before the character whose position is given
              by 4mindex24m.  If some or all of the items given  by  4mtagOrId24m  don't
              support  an  insertion cursor then this command has no effect on
              them.  See INDICES above for a description of  the  legal  forms
              for  4mindex24m.  Note:  the insertion cursor is only displayed in an
              item if that item currently has the keyboard focus (see the wid-
              get  command  1mfocus22m,  below), but the cursor position may be set
              even when the item doesn't have the focus.  This command returns
              an empty string.

       4mpathName24m 1mindex 4m22mtagOrId24m 4mindex0m
              This command returns a decimal string giving the numerical index
              within 4mtagOrId24m corresponding to 4mindex24m.  4mIndex24m  gives  a  textual
              description  of  the  desired  position  as described in INDICES
              above.  Text items interpret 4mindex24m 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 4mtagOrId24m refers to multiple items, then the  index
              is  processed in the first of these items that supports indexing
              operations (in display list order).

       4mpathName24m 1minsert 4m22mtagOrId24m 4mbeforeThis24m 4mstring0m
              For each of the items given by 4mtagOrId24m,  if  the  item  supports
              text  or  coordinate, insertion then 4mstring24m is inserted into the
              item's text just before  the  character,  or  coordinate,  whose
              index  is  4mbeforeThis24m.   Text  items  interpret 4mbeforeThis24m 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
              4mstring24m must be a valid coordinate sequence.  See  INDICES  above
              for  information  about  the forms allowed for 4mbeforeThis24m.  This
              command returns an empty string.

       4mpathName24m 1mitemcget 4m22mtagOrId24m 4moption0m
              Returns the current value of the configuration  option  for  the
              item  given  by  4mtagOrId24m  whose name is 4moption24m.  This command is
              similar to the 1mcget 22mwidget command except that it applies  to  a
              particular  item  rather than the widget as a whole.  4mOption24m may
              have any of the values accepted by  the  1mcreate  22mwidget  command
              when  the  item was created.  If 4mtagOrId24m is a tag that refers to
              more than one item, the first (lowest) such item is used.

       4mpathName24m 1mitemconfigure 4m22mtagOrId24m ?4moption24m? ?4mvalue24m? ?4moption24m 4mvalue24m 4m...24m?
              This command is similar to the 1mconfigure 22mwidget  command  except
              that  it  modifies  item-specific options for the items given by
              4mtagOrId24m instead of modifying options for the overall canvas wid-
              get.   If  no 4moption24m is specified, returns a list describing all
              of the available options for the first  item  given  by  4mtagOrId0m
              (see  1mTk_ConfigureInfo  22mfor  information  on  the format of this
              list).  If 4moption24m is specified with no 4mvalue24m, 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  4moption24m is specified).  If one or more 4moption-value24m 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 4mtagOrId24m;  in this case the command returns an  empty  string.
              The  4moption24ms and 4mvalue24ms are the same as those permissible in the
              1mcreate 22mwidget command when the item(s)  were  created;  see  the
              sections  describing  individual item types below for details on
              the legal options.

       4mpathName24m 1mlower 4m22mtagOrId24m ?4mbelowThis24m?
              Move all of the items given by 4mtagOrId24m to a new position in  the
              display  list  just  before  the  item  given  by 4mbelowThis24m.  If
              4mtagOrId24m refers to more than one item then all are moved but  the
              relative   order  of  the  moved  items  will  not  be  changed.
              4mBelowThis24m 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 1mraise 22mand 1mlower 22mcommands, not the 1mraise 22mand
              1mlower 22mwidget commands for canvases.   This  command  returns  an
              empty string.

       4mpathName24m 1mmove 4m22mtagOrId24m 4mxAmount24m 4myAmount0m
              Move each of the items given by 4mtagOrId24m in the canvas coordinate
              space by adding 4mxAmount24m to the x-coordinate of each point  asso-
              ciated  with  the  item  and 4myAmount24m to the y-coordinate of each
              point associated with the item.  This command returns  an  empty
              string.

       4mpathName24m 1mpostscript 22m?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              Generate a Postscript representation for part or all of the can-
              vas.  If the 1m-file 22moption 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 opera-
              tion will fail because safe  interpreters  are  not  allowed  to
              write  files.  If the 1m-channel 22moption 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 Post-
              script  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 1m-width 22mand 1m-height 22moptions
              to  specify  the  area of the canvas to print.  The 4moption24m-4mvalue0m
              argument pairs provide additional  information  to  control  the
              generation of Postscript.  The following options are supported:

              1m-colormap 4m22mvarName0m
                     4mVarName24m must be the name of an array variable that speci-
                     fies a color mapping to use in the Postscript.  Each ele-
                     ment  of 4mvarName24m must consist of Postscript code to set a
                     particular  color  value  (e.g.  ``1m1.0  1.0  0.0  setrgb-0m
                     1mcolor22m'').  When outputting color information in the Post-
                     script, Tk checks to see if there is an element  of  4mvar-0m
                     4mName24m 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 hasn't been specified, or if there
                     isn't an entry in 4mvarName24m for a given color, then Tk uses
                     the red, green, and blue intensities from the X color.

              1m-colormode 4m22mmode0m
                     Specifies  how to output color information.  4mMode24m must be
                     either 1mcolor 22m(for full color output), 1mgray  22m(convert  all
                     colors  to their gray-scale equivalents) or 1mmono 22m(convert
                     all colors to black or white).

              1m-file 4m22mfileName0m
                     Specifies the name of the file  in  which  to  write  the
                     Postscript.   If  this  option  isn't  specified then the
                     Postscript is returned  as  the  result  of  the  command
                     instead of being written to a file.

              1m-fontmap 4m22mvarName0m
                     4mVarName24m must be the name of an array variable that speci-
                     fies a font mapping to use in the Postscript.  Each  ele-
                     ment  of 4mvarName24m must consist of a Tcl list with two ele-
                     ments, which are the name and point size of a  Postscript
                     font.  When outputting Postscript commands for a particu-
                     lar font, Tk checks to see if 4mvarName24m contains an element
                     with the same name as the font.  If there is such an ele-
                     ment, 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  gener-
                     ally  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 exam-
                     ple,  1m-*-Courier-Bold-R-Normal--*-120-*  22mwill  work   but
                     1m*Courier-Bold-R-Normal*120*   22mwill  not;   Tk  needs  the
                     dashes to parse the font name).

              1m-height 4m22msize0m
                     Specifies the height of the area of the canvas to  print.
                     Defaults to the height of the canvas window.

              1m-pageanchor 4m22manchor0m
                     Specifies  which  point of the printed area of the canvas
                     should appear over the  positioning  point  on  the  page
                     (which  is  given by the 1m-pagex 22mand 1m-pagey 22moptions).  For
                     example, 1m-pageanchor n 22mmeans 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 1mcenter22m.

              1m-pageheight 4m22msize0m
                     Specifies  that the Postscript should be scaled in both x
                     and y so that the printed area is 4msize24m high on the  Post-
                     script  page.   4mSize24m  consists of a floating-point number
                     followed by 1mc 22mfor centimeters, 1mi 22mfor inches, 1mm  22mfor  mil-
                     limeters,  or  1mp  22mor  nothing  for printer's points (1/72
                     inch).  Defaults to the height of the printed area on the
                     screen.  If both 1m-pageheight 22mand 1m-pagewidth 22mare specified
                     then the scale factor from 1m-pagewidth 22mis  used  (non-uni-
                     form scaling is not implemented).

              1m-pagewidth 4m22msize0m
                     Specifies  that the Postscript should be scaled in both x
                     and y so that the printed area is 4msize24m wide on the  Post-
                     script  page.  4mSize24m has the same form as for 1m-pageheight22m.
                     Defaults to the width of the printed area on the  screen.
                     If both 1m-pageheight 22mand 1m-pagewidth 22mare specified then the
                     scale factor from 1m-pagewidth  22mis used (non-uniform  scal-
                     ing is not implemented).

              1m-pagex 4m22mposition0m
                     4mPosition24m  gives the x-coordinate of the positioning point
                     on the Postscript page, using any of  the  forms  allowed
                     for 1m-pageheight22m.  Used in conjunction with the 1m-pagey 22mand
                     1m-pageanchor 22moptions to determine where the  printed  area
                     appears  on  the Postscript page.  Defaults to the center
                     of the page.

              1m-pagey 4m22mposition0m
                     4mPosition24m gives the y-coordinate of the positioning  point
                     on  the  Postscript  page, using any of the forms allowed
                     for 1m-pageheight22m.  Used in conjunction with the 1m-pagex 22mand
                     1m-pageanchor  22moptions  to determine where the printed area
                     appears on the Postscript page.  Defaults to  the  center
                     of the page.

              1m-rotate 4m22mboolean0m
                     4mBoolean24m  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 (``land-
                     scape'' orientation).  Defaults to non-rotated.

              1m-width 4m22msize0m
                     Specifies the width of the area of the canvas  to  print.
                     Defaults to the width of the canvas window.

              1m-x 4m22mposition0m
                     Specifies  the  x-coordinate of the left edge of the area
                     of the canvas that is to be printed,  in  canvas  coordi-
                     nates,  not  window coordinates.  Defaults to the coordi-
                     nate of the left edge of the window.

              1m-y 4m22mposition0m
                     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.

       4mpathName24m 1mraise 4m22mtagOrId24m ?4maboveThis24m?
              Move  all of the items given by 4mtagOrId24m to a new position in the
              display list just after the item given by 4maboveThis24m.  If 4mtagOrId0m
              refers to more than one item then all are moved but the relative
              order of the moved items will not be changed.   4mAboveThis24m  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 des-
              tination  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 1mraise 22mand 1mlower 22mcommands, not the 1mraise 22mand 1mlower  22mwidget
              commands for canvases.  This command returns an empty string.

       4mpathName24m 1mscale 4m22mtagOrId24m 4mxOrigin24m 4myOrigin24m 4mxScale24m 4myScale0m
              Rescale  all  of the items given by 4mtagOrId24m in canvas coordinate
              space.  4mXOrigin24m and 4myOrigin24m identify the origin for the  scaling
              operation  and  4mxScale24m and 4myScale24m 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 4mxOrigin24m by a factor of 4mxScale24m.  Similarly, each y-
              coordinate is adjusted to change the distance from 4myOrigin24m by  a
              factor of 4myScale24m.  This command returns an empty string.

       4mpathName24m 1mscan 4m22moption24m 4margs0m
              This  command is used to implement scanning on canvases.  It has
              two forms, depending on 4moption24m:

              4mpathName24m 1mscan mark 4m22mx24m 4my0m
                     Records 4mx24m and 4my24m and the canvas's current view;   used  in
                     conjunction  with  later 1mscan dragto 22mcommands.  Typically
                     this command is associated with a mouse button  press  in
                     the  widget and 4mx24m and 4my24m are the coordinates of the mouse.
                     It returns an empty string.

              4mpathName24m 1mscan dragto 4m22mx24m 4my24m 4m?gain?24m.
                     This command computes the difference between its 4mx24m and  4my0m
                     arguments (which are typically mouse coordinates) and the
                     4mx24m and 4my24m arguments to the last 1mscan mark 22mcommand  for  the
                     widget.   It then adjusts the view by 4mgain24m times the dif-
                     ference in coordinates, where 4mgain24m defaults to 10.   This
                     command  is typically associated with mouse motion events
                     in the widget, to produce the effect of dragging the can-
                     vas  at  high speed through its window.  The return value
                     is an empty string.

       4mpathName24m 1mselect 4m22moption24m ?4mtagOrId24m 4marg24m?
              Manipulates the selection in one of several ways,  depending  on
              4moption24m.   The command may take any of the forms described below.
              In all of the descriptions below, 4mtagOrId24m 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.  4mIndex24m gives a textual description of a posi-
              tion within 4mtagOrId24m, as described in INDICES above.

              4mpathName24m 1mselect adjust 4m22mtagOrId24m 4mindex0m
                     Locate the end of the selection in 4mtagOrId24m nearest to the
                     character  given  by  4mindex24m,  and  adjust that end of the
                     selection to be at 4mindex24m (i.e. including  but  not  going
                     beyond  4mindex24m).   The  other end of the selection is made
                     the anchor point for future 1mselect to 22mcommands.   If  the
                     selection  isn't  currently  in 4mtagOrId24m then this command
                     behaves  the  same  as  the  1mselect  to  22mwidget  command.
                     Returns an empty string.

              4mpathName24m 1mselect clear0m
                     Clear  the  selection  if  it  is in this widget.  If the
                     selection isn't in this widget then the  command  has  no
                     effect.  Returns an empty string.

              4mpathName24m 1mselect from 4m22mtagOrId24m 4mindex0m
                     Set  the selection anchor point for the widget to be just
                     before the character given by 4mindex24m in the item given  by
                     4mtagOrId24m.   This command doesn't change the selection;  it
                     just sets the fixed  end  of  the  selection  for  future
                     1mselect to 22mcommands.  Returns an empty string.

              4mpathName24m 1mselect item0m
                     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.

              4mpathName24m 1mselect to 4m22mtagOrId24m 4mindex0m
                     Set  the  selection  to  consist  of  those characters of
                     4mtagOrId24m between the selection  anchor  point  and  4mindex24m.
                     The  new  selection  will  include the character given by
                     4mindex24m; it will include the character given by the  anchor
                     point  only  if  4mindex24m  is  greater  than or equal to the
                     anchor point.  The anchor point is determined by the most
                     recent 1mselect adjust 22mor 1mselect from 22mcommand for this wid-
                     get.  If the selection anchor point for the widget  isn't
                     currently  in 4mtagOrId24m, then it is set to the same charac-
                     ter given by 4mindex24m.  Returns an empty string.

       4mpathName24m 1mtype 4m22mtagOrId0m
              Returns the type of the item given by 4mtagOrId24m, such as 1mrectangle0m
              or 1mtext22m.  If 4mtagOrId24m refers to more than one item, then the type
              of the first item in the display list is returned.   If  4mtagOrId0m
              doesn't  refer  to  any  items  at  all  then an empty string is
              returned.

       4mpathName24m 1mxview  22m?4margs24m?
              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:

              4mpathName24m 1mxview0m
                     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 ele-
                     ment is .6, 20% of the canvas's area (as defined  by  the
                     1m-scrollregion 22moption) is off-screen to the left, the mid-
                     dle 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 1m-xscrollcommand 22moption.

              4mpathName24m 1mxview moveto 4m22mfraction0m
                     Adjusts the view in the window so that  4mfraction24m  of  the
                     total  width  of  the  canvas  is off-screen to the left.
                     4mFraction24m must be a fraction between 0 and 1.

              4mpathName24m 1mxview scroll 4m22mnumber24m 4mwhat0m
                     This command shifts the view in the window left or  right
                     according to 4mnumber24m and 4mwhat24m.  4mNumber24m must be an integer.
                     4mWhat24m must be either 1munits 22mor 1mpages 22mor an abbreviation  of
                     one of these.  If 4mwhat24m is 1munits22m, the view adjusts left or
                     right in units of the 1mxScrollIncrement 22moption, if  it  is
                     greater  than zero, or in units of one-tenth the window's
                     width otherwise.  If 4mwhat24m 4mis24m 1mpages 22mthen the view  adjusts
                     in units of nine-tenths the window's width.  If 4mnumber24m is
                     negative then information farther  to  the  left  becomes
                     visible;   if  it is positive then information farther to
                     the right becomes visible.

       4mpathName24m 1myview 4m22m?args24m?
              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:

              4mpathName24m 1myview0m
                     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 ele-
                     ment is 1.0, the lowest 40%  of  the  canvas's  area  (as
                     defined  by  the  1m-scrollregion 22moption) is visible in the
                     window.  These are the same values passed  to  scrollbars
                     via the 1m-yscrollcommand 22moption.

              4mpathName24m 1myview moveto 4m22mfraction0m
                     Adjusts  the  view  in the window so that 4mfraction24m of the
                     canvas's area is off-screen to the top.   4mFraction24m  is  a
                     fraction between 0 and 1.

              4mpathName24m 1myview scroll 4m22mnumber24m 4mwhat0m
                     This  command  adjusts  the view in the window up or down
                     according to 4mnumber24m and 4mwhat24m.  4mNumber24m must be an integer.
                     4mWhat24m  must  be  either 1munits 22mor 1mpages22m.  If 4mwhat24m is 1munits22m,
                     the view adjusts up or down in units of the 1myScrollIncre-0m
                     1mment  22moption,  if it is greater than zero, or in units of
                     one-tenth the window's  height  otherwise.   If  4mwhat24m  is
                     1mpages  22mthen  the view adjusts in units of nine-tenths the
                     window's height.   If  4mnumber24m  is  negative  then  higher
                     information  becomes  visible;   if  it  is positive then
                     lower information becomes visible.

1mOVERVIEW OF ITEM TYPES0m
       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 1mcreate 22mcommand 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  1mcreate  22mand  1mitemconfigure  22mwidget  commands.
       Most  items don't support indexing or selection or the commands related
       to them, such as 1mindex 22mand 1minsert22m.  Where items do support these facil-
       ities,  it  is noted explicitly in the descriptions below.  At present,
       text, line and polygon items provide this support.  For lines and poly-
       gons the indexing facility is used to manipulate the coordinates of the
       item.

1mCOMMON ITEM OPTIONS0m
       Many items share a common set of options.  These options are  explained
       here, and then referred to be each widget type for brevity.


       1m-dash 4m22mpattern0m

       1m-activedash 4m22mpattern0m

       1m-disableddash 4m22mpattern0m
              This  option  specifies  dash  patterns  for  the normal, active
              state, and disabled state of an item.  4mpattern24m may have  any  of
              the forms accepted by 1mTk_GetDash22m.  If the dash options are omit-
              ted then the default is a solid outline.   See  "DASH  PATTERNS"
              for more information.

       1m-dashoffset 4m22moffset0m
              The  starting  4moffset24m in pixels into the pattern provided by the
              1m-dash 22moption.  1m-dashoffset 22mis ignored if there is no 1m-dash  22mpat-
              tern.   The  4moffset24m  may  have any of the forms described in the
              1mCOORDINATES 22msection above.

       1m-fill 4m22mcolor0m

       1m-activefill 4m22mcolor0m

       1m-disabledfill 4m22mcolor0m
              Specifies the color to be used to fill item's area.  in its nor-
              mal,  active,  and  disabled  states,  4mColor24m may have any of the
              forms accepted by 1mTk_GetColor22m.  If 4mcolor24m is an empty string (the
              default),  then the item will not be filled.  For the line item,
              it specifies the color of the line drawn.  For the text item, it
              specifies the foreground color of the text.

       1m-outline 4m22mcolor0m

       1m-activeoutline 4m22mcolor0m

       1m-disabledoutline 4m22mcolor0m
              This  option specifies the color that should be used to draw the
              outline of the item in its normal, active and  disabled  states.
              4mColor24m  may  have any of the forms accepted by 1mTk_GetColor22m.  This
              option defaults to 1mblack22m.  If 4mcolor24m is  specified  as  an  empty
              string then no outline is drawn for the item.

       1m-offset 4m22moffset0m
              Specifies  the  offset  of stipples.  The offset value can be of
              the form 1mx,y 22mor 1mside22m, where side can be 1mn22m, 1mne22m, 1me22m, 1mse22m, 1ms22m, 1msw22m,  1mw22m,
              1mnw22m, or 1mcenter22m. In the first case the origin is the origin of the
              toplevel of the current window.  For the canvas itself and  can-
              vas  objects  the  origin is the canvas origin, but putting 1m# 22min
              front of the coordinate pair indicates using the toplevel origin
              instead.  For  canvas  objects,  the  1m-offset 22moption is used for
              stippling as well.  For the line and polygon  canvas  items  you
              can  also specify an index as argument, which connects the stip-
              ple origin to one of the coordinate points of the  line/polygon.

       1m-outlinestipple 4m22mbitmap0m

       1m-activeoutlinestipple 4m22mbitmap0m

       1m-disabledoutlinestipple 4m22mbitmap0m
              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; 4mbitmap24m specifies the stipple pattern  to
              use, in any of the forms accepted by 1mTk_GetBitmap22m.  If the 1m-out-0m
              1mline 22moption hasn't  been  specified  then  this  option  has  no
              effect.   If  4mbitmap24m  is an empty string (the default), then the
              outline is drawn in a solid fashion.

       1m-stipple 4m22mbitmap0m

       1m-activestipple 4m22mbitmap0m

       1m-disabledstipple 4m22mbitmap0m
              This option specifies stipple patterns that should  be  used  to
              fill the item in its normal, active and disabled states.  4mbitmap0m
              specifies the stipple pattern  to  use,  in  any  of  the  forms
              accepted by 1mTk_GetBitmap22m.  If the 1m-fill 22moption hasn't been spec-
              ified then this option has no effect.  If  4mbitmap24m  is  an  empty
              string  (the  default), then filling is done in a solid fashion.
              For the text item, it affects the actual text.

       1m-state 4m22mstate0m
              This allows an item to override the canvas widget's global 4mstate0m
              option.  It takes the same values: 4mnormal24m, 4mdisabled24m or 4mhidden24m.

       1m-tags 4m22mtagList0m
              Specifies  a set of tags to apply to the item.  4mTagList24m consists
              of a list of tag names, which replace any existing tags for  the
              item.  4mTagList24m may be an empty list.

       1m-width 4m22moutlineWidth0m

       1m-activewidth 4m22moutlineWidth0m

       1m-disabledwidth 4m22moutlineWidth0m
              Specifies the width of the outline to be drawn around the item's
              region, in its normal, active and disabled states.  4moutlineWidth0m
              may  be in any of the forms described in the 1mCOORDINATES 22msection
              above.  If the 1m-outline 22moption 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.

1mARC ITEMS0m
       Items  of type 1marc 22mappear on the display as arc-shaped regions.  An arc
       is a section of an oval delimited  by  two  angles  (specified  by  the
       1m-start 22mand 1m-extent 22moptions) and displayed in one of several ways (spec-
       ified by the 1m-style 22moption).  Arcs are created with widget commands  of
       the following form:
              4mpathName24m 1mcreate arc 4m22mx124m 4my124m 4mx224m 4my224m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate arc 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The  arguments  4mx124m, 4my124m, 4mx224m, and 4my224m or 4mcoordList24m 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 num-
       ber of 4moption24m-4mvalue24m pairs, each of which sets one of the  configuration
       options  for  the  item.   These same 4moption24m-4mvalue24m pairs may be used in
       1mitemconfigure 22mwidget commands to change the item's configuration.
       The following standard options are supported by arcs:
              -dash
              -activedash
              -disableddash
              -dashoffset
              -fill
              -activefill
              -disabledfill
              -offset
              -outline
              -activeoutline
              -disabledoutline
              -outlinestipple
              -activeoutlinestipple
              -disabledoutlinestipple
              -stipple
              -activestipple
              -disabledstipple
              -state
              -tags
              -width
              -activewidth
              -disabledwidth
       The following extra options are supported for arcs:

       1m-extent 4m22mdegrees0m
              Specifies the size of the angular range  occupied  by  the  arc.
              The  arc's  range  extends for 4mdegrees24m degrees counter-clockwise
              from the starting angle given by the 1m-start 22moption.  4mDegrees24m may
              be  negative.  If it is greater than 360 or less than -360, then
              4mdegrees24m modulo 360 is used as the extent.

       1m-start 4m22mdegrees0m
              Specifies the beginning of the angular  range  occupied  by  the
              arc.   4mDegrees24m  is  given  in units of degrees measured counter-
              clockwise from the 3-o'clock position;  it may be  either  posi-
              tive or negative.

       1m-style 4m22mtype0m
              Specifies  how  to  draw  the  arc.   If  4mtype24m  is 1mpieslice 22m(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  4mtype24m  is
              1mchord  22mthen  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 4mtype24m is 1marc 22mthen the
              arc's region consists of a section of the perimeter  alone.   In
              this last case the 1m-fill 22moption is ignored.

1mBITMAP ITEMS0m
       Items  of  type 1mbitmap 22mappear on the display as images with two colors,
       foreground and background.  Bitmaps are created with widget commands of
       the following form:
              4mpathName24m 1mcreate bitmap 4m22mx24m 4my24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate bitmap 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The  arguments  4mx24m and 4my24m or 4mcoordList24m specify the coordinates of a point
       used to position the bitmap on the  display  (see  the  1m-anchor  22moption
       below  for  more  information on how bitmaps are displayed).  After the
       coordinates there may be any number  of  4moption24m-4mvalue24m  pairs,  each  of
       which  sets  one of the configuration options for the item.  These same
       4moption24m-4mvalue24m pairs may be used  in  1mitemconfigure  22mwidget  commands  to
       change the item's configuration.
       The following standard options are supported by bitmaps:
              -state
              -tags
       The following extra options are supported for bitmaps:

       1m-anchor 4m22manchorPos0m
              4mAnchorPos24m tells how to position the bitmap relative to the posi-
              tioning point for the item;   it  may  have  any  of  the  forms
              accepted  by  1mTk_GetAnchor22m.  For example, if 4manchorPos24m is 1mcenter0m
              then the bitmap is centered on the point;   if  4manchorPos24m  is  1mn0m
              then the bitmap will be drawn so that its top center point is at
              the positioning point.  This option defaults to 1mcenter22m.

       1m-background 4m22mcolor0m

       1m-activebackground 4m22mbitmap0m

       1m-disabledbackground 4m22mbitmap0m
              Specifies the color to use for each of the bitmap's  '0'  valued
              pixels  in  its  normal,  active and disabled states.  4mColor24m may
              have any of the forms accepted by 1mTk_GetColor22m.  If  this  option
              isn't  specified, or if it is specified as an empty string, then
              nothing is displayed where the bitmap pixels are 0;   this  pro-
              duces a transparent effect.

       1m-bitmap 4m22mbitmap0m

       1m-activebitmap 4m22mbitmap0m

       1m-disabledbitmap 4m22mbitmap0m
              Specifies  the  bitmaps  to  display  in the item in its normal,
              active and disabled states.  4mBitmap24m may have any  of  the  forms
              accepted by 1mTk_GetBitmap22m.

       1m-foreground 4m22mcolor0m

       1m-activeforeground 4m22mbitmap0m

       1m-disabledforeground 4m22mbitmap0m
              Specifies  the  color to use for each of the bitmap's '1' valued
              pixels in its normal, active and  disabled  states.   4mColor24m  may
              have  any  of  the forms accepted by 1mTk_GetColor 22mand defaults to
              1mblack22m.

1mIMAGE ITEMS0m
       Items of type 1mimage 22mare used to display images on a canvas.  Images are
       created with widget commands of the following form:
              4mpathName24m 1mcreate image 4m22mx24m 4my24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate image 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The  arguments  4mx24m and 4my24m or 4mcoordList24m specify the coordinates of a point
       used to position the image on the display (see the 1m-anchor 22moption below
       for  more  information).  After the coordinates there may be any number
       of 4moption24m-4mvalue24m pairs, each of which  sets  one  of  the  configuration
       options  for  the  item.   These same 4moption24m-4mvalue24m pairs may be used in
       1mitemconfigure 22mwidget commands to change the item's configuration.
       The following standard options are supported by images:
              -state
              -tags
       The following extra options are supported for images:

       1m-anchor 4m22manchorPos0m
              4mAnchorPos24m tells how to position the image relative to the  posi-
              tioning  point  for  the  item;   it  may  have any of the forms
              accepted by 1mTk_GetAnchor22m.  For example, if 4manchorPos24m  is  1mcenter0m
              then the image is centered on the point;  if 4manchorPos24m is 1mn 22mthen
              the image will be drawn so that its top center point is  at  the
              positioning point.  This option defaults to 1mcenter22m.

       1m-image 4m22mname0m

       1m-activeimage 4m22mname0m

       1m-disabledimage 4m22mname0m
              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 1mimage create 22mcommand.

1mLINE ITEMS0m
       Items  of type 1mline 22mappear on the display as one or more connected line
       segments or curves.  Line items support coordinate indexing  operations
       using  the  canvas  widget  commands: 1mdchars, index, insert.  22mLines are
       created with widget commands of the following form:
              4mpathName24m 1mcreate line 4m22mx124m 4my1...24m 4mxn24m 4myn24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate line 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The arguments 4mx124m through 4myn24m or 4mcoordList24m 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
       4moption24m-4mvalue24m pairs, each of which sets one of the configuration options
       for the item.  These same 4moption24m-4mvalue24m pairs may be used in 1mitemconfig-0m
       1mure 22mwidget commands to change the item's configuration.
       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:

       1m-arrow 4m22mwhere0m
              Indicates  whether  or  not arrowheads are to be drawn at one or
              both ends of the line.  4mWhere24m must have one of the  values  1mnone0m
              (for  no arrowheads), 1mfirst 22m(for an arrowhead at the first point
              of the line), 1mlast 22m(for an arrowhead at the last  point  of  the
              line),  or  1mboth  22m(for  arrowheads  at  both ends).  This option
              defaults to 1mnone22m.

       1m-arrowshape 4m22mshape0m
              This option indicates how to draw arrowheads.  The  4mshape24m  argu-
              ment  must be a list with three elements, each specifying a dis-
              tance in any of the forms described in the  1mCOORDINATES  22msection
              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 isn't specified then Tk picks  a  ``rea-
              sonable'' shape.

       1m-capstyle 4m22mstyle0m
              Specifies  the  ways  in  which caps are to be drawn at the end-
              points of the line.  4mStyle24m may have any of the forms accepted by
              1mTk_GetCapStyle  22m(1mbutt22m,  1mprojecting22m,  or  1mround22m).  If this option
              isn't specified then it defaults to 1mbutt22m.  Where arrowheads  are
              drawn the cap style is ignored.

       1m-joinstyle 4m22mstyle0m
              Specifies  the  ways in which joints are to be drawn at the ver-
              tices of the line.  4mStyle24m may have any of the forms accepted  by
              1mTk_GetCapStyle  22m(1mbevel22m,  1mmiter22m, or 1mround22m).  If this option isn't
              specified then it defaults to 1mmiter22m.  If the line only  contains
              two points then this option is irrelevant.

       1m-smooth 4m22msmoothMethod0m
              4msmoothMethod24m  must  have  one  of  the forms accepted by 1mTk_Get-0m
              1mBoolean 22mor a line smoothing method.  Only 1mbezier 22mis supported in
              the  core, 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  assume  1mbezier  22msmoothing.   It indicates
              whether or not the line should be drawn as a curve.  If so,  the
              line  is  rendered  as a set of parabolic 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.

       1m-splinesteps 4m22mnumber0m
              Specifies  the  degree  of  smoothness desired for curves:  each
              spline will be approximated with  4mnumber24m  line  segments.   This
              option is ignored unless the 1m-smooth 22moption is true.


1mOVAL ITEMS0m
       Items  of  type 1moval 22mappear 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:
              4mpathName24m 1mcreate oval 4m22mx124m 4my124m 4mx224m 4my224m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate oval 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The  arguments  4mx124m, 4my124m, 4mx224m, and 4my224m or 4mcoordList24m 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 result-
       ing  oval  is  circular; otherwise it is elongated in shape.  After the
       coordinates there may be any number  of  4moption24m-4mvalue24m  pairs,  each  of
       which  sets  one of the configuration options for the item.  These same
       4moption24m-4mvalue24m pairs may be used  in  1mitemconfigure  22mwidget  commands  to
       change the item's configuration.
       The following standard options are supported by ovals:
              -dash
              -activedash
              -disableddash
              -dashoffset
              -fill
              -activefill
              -disabledfill
              -offset
              -outline
              -activeoutline
              -disabledoutline
              -outlinestipple
              -activeoutlinestipple
              -disabledoutlinestipple
              -stipple
              -activestipple
              -disabledstipple
              -state
              -tags
              -width
              -activewidth
              -disabledwidth

1mPOLYGON ITEMS0m
       Items  of  type 1mpolygon 22mappear as polygonal or curved filled regions on
       the display.  Polygon  items  support  coordinate  indexing  operations
       using  the canvas widget commands: 1mdchars, index, insert.  22mPolygons are
       created with widget commands of the following form:
              4mpathName24m 1mcreate polygon 4m22mx124m 4my124m 4m...24m 4mxn24m 4myn24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate polygon 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The arguments 4mx124m through 4myn24m or 4mcoordList24m 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 4moption24m-4mvalue24m pairs, each of which  sets  one
       of  the  configuration  options  for the item.  These same 4moption24m-4mvalue0m
       pairs may be used in 1mitemconfigure 22mwidget commands to change the item's
       configuration.
       The following standard options are supported by polygons:
              -dash
              -activedash
              -disableddash
              -dashoffset
              -fill
              -activefill
              -disabledfill
              -offset
              -outline
              -activeoutline
              -disabledoutline
              -outlinestipple
              -activeoutlinestipple
              -disabledoutlinestipple
              -stipple
              -activestipple
              -disabledstipple
              -state
              -tags
              -width
              -activewidth
              -disabledwidth
       The following extra options are supported for polygons:

       1m-joinstyle 4m22mstyle0m
              Specifies  the  ways in which joints are to be drawn at the ver-
              tices of the outline.  4mStyle24m may have any of the forms  accepted
              by  1mTk_GetCapStyle  22m(1mbevel22m,  1mmiter22m,  or  1mround22m).  If this option
              isn't specified then it defaults to 1mmiter22m.

       1m-smooth 4m22mboolean0m
              4mBoolean24m must have one of the forms  accepted  by  1mTk_GetBoolean22m.
              It  indicates  whether or not the polygon should be drawn with a
              curved perimeter.  If so, the outline of the polygon  becomes  a
              set  of  parabolic  splines, one spline for the first and second
              line segments,  one  for  the  second  and  third,  and  so  on.
              Straight-line segments can be generated in a smoothed polygon by
              duplicating the end-points of the desired line segment.

       1m-splinesteps 4m22mnumber0m
              Specifies the degree of smoothness  desired  for  curves:   each
              spline  will  be  approximated  with 4mnumber24m line segments.  This
              option is ignored unless the 1m-smooth 22moption is true.

       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 1mfind  closest  22mand  1mfind  overlapping0m
       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.

1mRECTANGLE ITEMS0m
       Items  of  type 1mrectangle 22mappear 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:
              4mpathName24m 1mcreate rectangle 4m22mx124m 4my124m 4mx224m 4my224m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate rectangle 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The  arguments  4mx124m, 4my124m, 4mx224m, and 4my224m or 4mcoordList24m 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  4moption24m-4mvalue24m  pairs,
       each  of  which  sets  one  of  the configuration options for the item.
       These same 4moption24m-4mvalue24m pairs may be used in 1mitemconfigure 22mwidget  com-
       mands to change the item's configuration.
       The following standard options are supported by rectangles:
              -dash
              -activedash
              -disableddash
              -dashoffset
              -fill
              -activefill
              -disabledfill
              -offset
              -outline
              -activeoutline
              -disabledoutline
              -outlinestipple
              -activeoutlinestipple
              -disabledoutlinestipple
              -stipple
              -activestipple
              -disabledstipple
              -state
              -tags
              -width
              -activewidth
              -disabledwidth

1mTEXT ITEMS0m
       A  text  item  displays  a string of characters on the screen in one or
       more lines.  Text items support indexing and selection, along with  the
       following text-related canvas widget commands:  1mdchars22m, 1mfocus22m, 1micursor22m,
       1mindex22m, 1minsert22m, 1mselect22m.  Text items are created with widget commands  of
       the following form:
              4mpathName24m 1mcreate text 4m22mx24m 4my24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate text 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The  arguments  4mx24m and 4my24m or 4mcoordList24m 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 4moption24m-4mvalue24m pairs, each of which  sets  one
       of  the  configuration  options  for the item.  These same 4moption24m-4mvalue0m
       pairs may be used in 1mitemconfigure 22mwidget commands to change the item's
       configuration.
       The following standard options are supported by text items:
              -fill
              -activefill
              -disabledfill
              -stipple
              -activestipple
              -disabledstipple
              -state
              -tags
       The following extra options are supported for text items:

       1m-anchor 4m22manchorPos0m
              4mAnchorPos24m  tells  how to position the text relative to the posi-
              tioning point for the text;   it  may  have  any  of  the  forms
              accepted  by  1mTk_GetAnchor22m.  For example, if 4manchorPos24m is 1mcenter0m
              then the text is centered on the point;  if 4manchorPos24m is 1mn  22mthen
              the  text  will  be  drawn such that the top center point of the
              rectangular region occupied by the text will be at the position-
              ing point.  This option defaults to 1mcenter22m.

       1m-font 4m22mfontName0m
              Specifies  the  font  to use for the text item.  4mFontName24m may be
              any string acceptable to 1mTk_GetFont22m.  If this option isn't spec-
              ified, it defaults to a system-dependent font.

       1m-justify 4m22mhow0m
              Specifies  how  to  justify the text within its bounding region.
              4mHow24m must be one of the values  1mleft22m,  1mright22m,  or  1mcenter22m.   This
              option  will  only  matter  if the text is displayed as multiple
              lines.  If the option is omitted, it defaults to 1mleft22m.

       1m-text 4m22mstring0m
              4mString24m 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 1minsert 22mand  1mdelete  22mwidget
              commands.  This option defaults to an empty string.

       1m-width 4m22mlineLength0m
              Specifies  a  maximum  line  length  for the text, in any of the
              forms described in  the  1mCOORDINATES  22msection  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 4mlineLength24m is broken just
              before a space character to make the  line  shorter  than  4mline-0m
              4mLength24m;   the space character is treated as if it were a newline
              character.

1mWINDOW ITEMS0m
       Items of type 1mwindow 22mcause a particular window to  be  displayed  at  a
       given  position  on  the  canvas.  Window items are created with widget
       commands of the following form:
              4mpathName24m 1mcreate window 4m22mx24m 4my24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              4mpathName24m 1mcreate window 4m22mcoordList24m ?4moption24m 4mvalue24m 4moption24m 4mvalue24m 4m...24m?
       The arguments 4mx24m and 4my24m or 4mcoordList24m specify the coordinates of  a  point
       used  to  position  the  window  on the display (see the 1m-anchor 22moption
       below for more information on how bitmaps are  displayed).   After  the
       coordinates  there  may  be  any  number of 4moption24m-4mvalue24m pairs, each of
       which sets one of the configuration options for the item.   These  same
       4moption24m-4mvalue24m  pairs  may  be  used  in 1mitemconfigure 22mwidget commands to
       change the item's configuration.
       The following standard options are supported by window items:
              -state
              -tags
       The following extra options are supported for window items:

       1m-anchor 4m22manchorPos0m
              4mAnchorPos24m tells how to position the window relative to the posi-
              tioning  point  for  the  item;   it  may  have any of the forms
              accepted by 1mTk_GetAnchor22m.  For example, if 4manchorPos24m  is  1mcenter0m
              then  the  window  is  centered on the point;  if 4manchorPos24m is 1mn0m
              then the window will be drawn so that its top center point is at
              the positioning point.  This option defaults to 1mcenter22m.

       1m-height 4m22mpixels0m
              Specifies the height to assign to the item's window.  4mPixels24m may
              have any of the  forms  described  in  the  1mCOORDINATES  22msection
              above.  If this option isn't specified, or if it is specified as
              an empty string, then the window is  given  whatever  height  it
              requests internally.

       1m-width 4m22mpixels0m
              Specifies  the width to assign to the item's window.  4mPixels24m may
              have any of the  forms  described  in  the  1mCOORDINATES  22msection
              above.  If this option isn't specified, or if it is specified as
              an empty string, then the window  is  given  whatever  width  it
              requests internally.

       1m-window 4m22mpathName0m
              Specifies  the  window  to associate with this item.  The window
              specified by 4mpathName24m must either be a child of the canvas  wid-
              get  or a child of some ancestor of the canvas widget.  4mPathName0m
              may not refer to a top-level 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.

1mAPPLICATION-DEFINED ITEM TYPES0m
       It is possible for individual applications to define new item types for
       canvas widgets using C code.  See the documentation for  1mTk_CreateItem-0m
       1mType22m.

1mBINDINGS0m
       In  the  current implementation, new canvases are not given any default
       behavior:  you'll have to execute explicit Tcl  commands  to  give  the
       canvas its behavior.

1mCREDITS0m
       Tk's  canvas  widget  is a blatant ripoff of ideas from Joel Bartlett's
       4mezd24m program.  4mEzd24m 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  can-
       vases.


1mSEE ALSO0m
       bind(n), font(n), image(n), scrollbar(n)


1mKEYWORDS0m
