NAME

       tix - Manipulate internal states of the Tix library

SYNOPSIS

       tix option ?arg arg ...?

CONFIGURATION OPTIONS

       This  manual page descripts the tix command, which manipulates the internal states of the Tix library. If
       you're looking for a general introduction to the Tix library, please refer to the TixIntro manual page.

       The Tix application context supports the following configuration options. Usually, these options are  set
       using  the  X  resource  database, i.e., in the user's .Xdefault file. For example, to choose a different
       color scheme for the Tix widgets, these two lines can be added to the user's .Xdefault file:
              *TixScheme:  Gray *TixFontSet: 14Point
       [-binding binding] This is an obsolete option.  [-debug debug] Specifies whether the Tix  widgets  should
       run in debug mode.  [-fontset tixFontSet] Specifies the fontset to use for the Tix widgets. Valid options
       are WmDefault, TK, TkWin, 12Point and 14Point. TK specifies that the standard TK fonts  should  be  used.
       The  default  value  is  WmDefault.   [-scheme tixScheme]  Specifies  the color scheme to use for the Tix
       widgets. Valid options are WmDefault, TK, TkWin, Gray, Blue, Bisque, SGIGray and TixGray. If you want the
       standard TK color scheme, you can use the value TK.  The default value is WmDefault.
        '  [-schemepriority tixSchemePriority]  Specifies  the  priority  level  of the TK options set by th Tix
       schemes. Please refer to the TK option(n) manual page for a discussion  of  the  priority  level  of  Tix
       options.  The  default value is 79, which makes the Tix schemes at a higher priority than the settings in
       the .Xdefaults file. If you want to allow the Tix schemes  to  be  overridden  by  the  settings  in  the
       .Xdefaults file, you can set the following line in you .Xdefaults file: *TixSchemePriority: 21

DESCRIPTION

       The tix command provides access to miscellaneous elements of Tix's internal state and the Tix application
       context.  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 depending on the option argument.  The legal forms are:

       tix addbitmapdir directory
              Tix maintains a list of directory under which which the tix getimage and  tix  getbitmap  commands
              will  search  for  image  files.  The  standard  bitmap  directory  is  $TIX_LIBRARY/bitmaps.  The
              addbitmapdir command adds directory into this list. By using this command, the image files  of  an
              applications can also be located using the tix getimage ot tix getbitmap command.

       tix cget option
              Returns  the  current  value of the configuration option given by option. Option may be any of the
              options described in the CONFIGURATION OPTIONS section.

       tix configure ?option? ?value option value ...?
              Query or modify the configuration options  of  the  Tix  application  context.  If  no  option  is
              specified,  returns  a  list  describing  all  of  the available options (see Tk_ConfigureInfo for
              information on the format of this list).  If option is specified with no value, 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 option is specified).  If one or more option-value  pairs  are
              specified,  then the command modifies the given option(s) to have the given value(s); in this case
              the command returns an  empty  string.  Option  may  be  any  of  the  options  described  in  the
              CONFIGURATION OPTIONS section.

       tix filedialog ?class?
              Returns  the file selection dialog that may be shared among different modules of this application.
              This command will create a file selection dialog widget when it is called  the  first  time.  This
              dialog will be returned by all subsequent calls to tix filedialog. An optional class parameter can
              be passed to specified what type of file selection dialog widget is desired. Possible options  are
              tixFileSelectDialog or tixExFileSelectDialog.

       tix getbitmap name
              Locates  a  bitmap  file  of  the  name name.xpm or name in one of the bitmap directories (see the
              addbitmapdir command above). By using tix getbitmap, you can advoid hard coding the  pathnames  of
              the  bitmap  files  in  your application. When successful, it returns the complete pathname of the
              bitmap file, prefixed with the character @.  The returned value  can  be  used  to  configure  the
              -bitmap option of the TK and Tix widgets.

       tix getimage name
              Locates  an image file of the name name.xpm, name.xbm or name.ppm in one of the bitmap directories
              (see the addbitmapdir command above). If more than one file with  the  same  name  (but  different
              extensions)  exist,  then  the  image  type is chosen according to the depth of the X display: xbm
              images are chosen on monochrome displays and color images are chosen on color displays.  By  using
              tix  getimage,  you  can  advoid hard coding the pathnames of the image files in your application.
              When successful, this command returns the name of the newly created image, which can  be  used  to
              configure the -image option of the TK and Tix widgets.

       tix initstyle
              Init  the style defaults for Tix.  Prior to Tix 8.4 this was done by simply package requiring Tix,
              but this call is now required to explicitly use Tix style.

       tix option ?args ...?
              Manipulates the options manitained by the Tix scheme mechanism. Available options  are:  active_bg
              active_fg     bg   bold_font     dark1_bg      dark1_fg  dark2_bg     dark2_fg     disabled_fg  fg
              fixed_font  font inactive_bg inactive_fg input1_bg  input2_bg    italic_font  light1_bg  light1_fg
              light2_bg    light2_fg  menu_font    output1_bg   output2_bg  select_bg   select_fg   selector The
              arguments to the tix option command can take the following form(s):

              tix option get option
                     Returns the current value of option.

       tix resetoptions newScheme newFontSet ?newScmPrio?
              Resets the scheme and fontset of the Tix application to newScheme  and  newFontSet,  respectively.
              This  affects  only  those  widgets  created  after  this  call. Therefore, it is best to call the
              resetoptions command before the creation of any widgets in a Tix application.

              The optional parameter newScmPrio can be given to reset the priority level of the TK  options  set
              by the Tix schemes.

BUGS

       [1]    In  this  release of Tix, the following configuration options have been disabled. Assigning values
              to them will cause no effect: -binding -debug -fontset -scheme -schemepriority  In  addition,  the
              following  options  to  the  tix  command  have been disabled. Invoking the tix command with these
              options will cause no effect: resetoptions

       [2]    Because of the way TK handles the X option database, after tixwish  has  started  up,  it  is  not
              possible  to  reset the color schemes and font sets using the tix config command. Instead, the tix
              resetoptions command must be used.

       The tk_setPalette command does not work very well under Tix. To use it, one must follow these steps:
              tix resetoptions TK TK tk_setPalette lightblue

KEYWORDS

       file selection dialog