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

1mKEYWORDS0m
