NAME

       tix - Manipulate internal states of the Tix library


SYNOPSIS

       tix option ?arg arg ...?


CONFIGURATION OPTIONS

       This  manual page descripts the tix command, which manipu­
       lates 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 config­
       uration  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

       Command-Line Name:-binding
       Database Name:  binding
       Database Class: Binding

              This is an obsolete option.

       Command-Line Name:-debug
       Database Name:  debug
       Database Class: Debug

              Specifies  whether  the  Tix  widgets should run in
              debug mode.

       Command-Line Name:-fontset
       Database Name:  tixFontSet
       Database Class: TixFontSet

              Specifies the fontset to use for the  Tix  widgets.
              Valid  options  are TK, TkWin, 12Point and 14Point.
              TK specifies that the standard TK fonts  should  be
              used. The default value is 14Point.

       Command-Line Name:-scheme
       Database Name:  tixScheme
       Database Class: TixScheme

              Specifies  the color scheme to use for the Tix wid­
              gets. Valid options  are  TK,  TkWin,  Gray,  Blue,
              Bisque,  SGIGray  and TixGray. The default value is
              TixGray. If you want the standard TK color  scheme,
              you can use the value TK. If you want to use the TK

              Bisque.

       Command-Line Name:-schemepriority
       Database Name:  tixSchemePriority
       Database Class: 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 set­
              tings in the .Xdefaults file, you can set the  fol­
              lowing 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 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 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 direc­
              tory is $TIX_LIBRARY/bitmaps. The addbitmapdir com­
              mand  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 get­
              bitmap 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 sec­
              tion.

       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

              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 dia­
              log 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 tix­
              FileSelectDialog 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  get­
              bitmap, you can advoid hard coding the pathnames of
              the bitmap files in your application. When success­
              ful, 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 directo­
              ries (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 getim­
              age, you can advoid hard coding  the  pathnames  of
              the  image files in your application. When success­
              ful, 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 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

       The  arguments to the tix option command can take the fol­
       lowing 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  applica­
              tion  to  newScheme  and  newFontSet, respectively.
              This affects only those widgets created after  this
              call.  Therefore,  it  is best to call the resetop­
              tions 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


Man(1) output converted with man2html