Provided by: tix-dev_8.4.3-10_amd64 bug

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