Manual Pages for UNIX Operating System command usage for man tk

Tk Built-In Commands                                       tk(1T)



_________________________________________________________________

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 manipulated by
     this command pertains 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  depend-
     ing 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 capitals 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 caret window ?-x x? ?-y y? ?-height height?                     ||
          Sets  and queries the caret location for the display of  |
          the specified Tk window window.  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 set-  |
          ting the caret are return in option-value pair  format.  |
          -x  and  -y  represent window-relative coordinates, and  |
          -height is the height of the current  cursor  location,  |
          or the height of the specified window if none is given.

     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



Tk                      Last change: 8.4                        1






Tk Built-In Commands                                       tk(1T)



          argument  is a floating point number that specifies the
          number of pixels per point on window'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 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 pix-
          els per point, which is the setting for a 90 dpi  moni-
          tor;  setting  the  scaling  factor to 1.25 on a 72 dpi
          monitor would cause everything in the application to be
          displayed  1.25  times as large as normal.  The initial
          value for the scaling factor is set when  the  applica-
          tion starts, based on properties of the installed moni-
          tor, 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  exist-
          ing  widgets  will  resize  themselves  dynamically  to
          accommodate 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  omitted,  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.                            |

     tk windowingsystem                                                 ||
          Returns  the  current  Tk  windowing system, one of x11  |
          (X11-based), win32 (MS Windows), classic (Mac OS  Clas-  |
          sic), or aqua (Mac OS X Aqua).

KEYWORDS
     application name, send

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










Tk                      Last change: 8.4                        2






Tk Built-In Commands                                       tk(1T)



     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tk-8   |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tk is available on http://opensolaris.org.













































Tk                      Last change: 8.4                        3