1mNAME0m
       tk - Manipulate Tk internal state

1mSYNOPSIS0m
       1mtk 4m22moption24m ?4marg24m 4marg24m 4m...24m?


1mDESCRIPTION0m
       The 1mtk 22mcommand provides access to miscellaneous elements of Tk's inter-
       nal state.  Most of the information manipulated by  this  command  per-
       tains  to the application as a whole, or to a screen or display, rather
       than to a particular window.  The command can take any of a  number  of
       different forms depending on the 4moption24m argument.  The legal forms are:

       1mtk appname 22m?4mnewName24m?
              If 4mnewName24m isn't specified, this command returns the name of the
              application  (the name that may be used in 1msend 22mcommands to com-
              municate with the application).  If 4mnewName24m is  specified,  then
              the name of the application is changed to 4mnewName24m.  If the given
              name is already in use, then a suffix of the form `` 1m#222m'' or  ``
              1m#322m''  is  appended  in  order to make the name unique.  The com-
              mand's result is the name actually chosen.  4mnewName24m  should  not
              start  with  a  capital letter.  This will interfere with option
              processing, since names starting with capitals are assumed to be
              classes;   as  a result, Tk may not be able to find some options
              for the application.  If sends have been  disabled  by  deleting
              the  1msend  22mcommand, this command will reenable them and recreate
              the 1msend 22mcommand.

       1mtk caret window 22m?1m-x 4m22mx24m? ?1m-y 4m22my24m? ?1m-height 4m22mheight24m?
              Sets and queries the caret location for the display of the spec-
              ified  Tk  window  4mwindow24m.   The caret is the per-display cursor
              location used for indicating global focus (e.g. to  comply  with
              Microsoft  Accessibility guidelines), as well as for location of
              the over-the-spot XIM (X Input Methods) or Windows IME  windows.
              If  no  options  are specified, the last values used for setting
              the caret are return in option-value pair  format.   4m-x24m  and  4m-y0m
              represent window-relative coordinates, and 4m-height24m is the height
              of the current cursor location, or the height of  the  specified
              4mwindow24m if none is given.

       1mtk scaling 22m?1m-displayof 4m22mwindow24m? ?4mnumber24m?
              Sets  and  queries the current scaling factor used by Tk to con-
              vert between physical units (for  example,  points,  inches,  or
              millimeters)  and  pixels.   The  4mnumber24m  argument is a floating
              point number that specifies the number of pixels  per  point  on
              4mwindow24m's  display.   If  the  4mwindow24m  argument  is  omitted,  it
              defaults to the main window.  If the 4mnumber24m argument is omitted,
              the current value of the scaling factor is returned.

              A  ``point''  is  a  unit  of measurement equal to 1/72 inch.  A
              scaling factor of 1.0 corresponds to 1 pixel per point, which is
              equivalent  to  a  standard 72 dpi monitor.  A scaling factor of
              1.25 would mean 1.25 pixels per point, which is the setting  for
              a 90 dpi monitor; setting the scaling factor to 1.25 on a 72 dpi
              monitor would cause everything in the  application  to  be  dis-
              played 1.25 times as large as normal.  The initial value for the
              scaling factor is set when  the  application  starts,  based  on
              properties  of  the  installed monitor, but it can be changed at
              any time.  Measurements made after the scaling factor is changed
              will  use  the  new  scaling factor, but it is undefined whether
              existing widgets will resize themselves dynamically  to  accomo-
              date the new scaling factor.

       1mtk useinputmethods 22m?1m-displayof 4m22mwindow24m? ?4mboolean24m?
              Sets and queries the state of whether Tk should use XIM (X Input
              Methods) for filtering events.  The resulting state is returned.
              XIM  is  used  in some locales (ie: Japanese, Korean), to handle
              special input devices.  This feature is only significant  on  X.
              If  XIM support is not available, this will always return 0.  If
              the 4mwindow24m argument is omitted, it defaults to the main  window.
              If  the  4mboolean24m  argument  is  omitted,  the  current  state is
              returned.  This is turned on by default for the main display.

       1mtk windowingsystem0m
              Returns the current Tk windowing system, one of 1mx11 22m(X11-based),
              1mwin32  22m(MS Windows), 1mclassic 22m(Mac OS Classic), or 1maqua 22m(Mac OS X
              Aqua).

1mKEYWORDS0m
