NAME

       tk - Manipulate Tk internal state


SYNOPSIS

       tk option ?arg arg ...?
_________________________________________________________________


DESCRIPTION

       The  tk  command provides access to miscellaneous elements
       of Tk's internal state.  Most of the  information  manipu­
       lated  by  this  command  pertains to the application as a
       whole, or to a screen or display, rather than to a partic­
       ular window.  The command can take any of a number of dif­
       ferent forms depending on the option argument.  The  legal
       forms are:

       tk appname ?newName?
              If  newName  isn't  specified, this command returns
              the name of the application (the name that  may  be
              used  in  send  commands  to  communicate  with the
              application).  If newName is  specified,  then  the
              name  of the application is changed to newName.  If
              the given name is already in use, then a suffix  of
              the form `` #2'' or `` #3'' is appended in order to
              make the name unique.  The command's result is  the
              name  actually  chosen.   newName  should not start
              with a capital letter.  This  will  interfere  with
              option  processing, since names starting with capi­
              tals are assumed to be classes;  as  a  result,  Tk
              may not be able to find some options for the appli­
              cation.  If sends have been  disabled  by  deleting
              the  send  command, this command will reenable them
              and recreate the send command.

       tk scaling ?-displayof window? ?number?
              Sets and queries the current scaling factor used by
              Tk  to convert between physical units (for example,
              points, inches, or millimeters)  and  pixels.   The
              number  argument  is  a  floating point number that
              specifies the number of pixels per  point  on  win­
              dow's  display.  If the window argument is omitted,
              it defaults to the  main  window.   If  the  number
              argument is omitted, the current value of the scal­
              ing 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

              the application to be displayed 1.25 times as large
              as normal.  The initial value for the scaling  fac­
              tor  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 wid­
              gets will resize themselves dynamically to  accomo­
              date the new scaling factor.

       tk useinputmethods ?-displayof window?                     |
              ?boolean?                  |                        |
              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 window argument  is  omit­ |
              ted,  it  defaults  to  the  main  window.   If the |
              boolean argument is omitted, the current  state  is |
              returned.   This  is  turned  on by default for the |
              main display.


KEYWORDS

       application name, send


Man(1) output converted with man2html