1tix(n)                       Tix Built-In Commands                      tix(n)
2
3
4

NAME

6       tix - Manipulate internal states of the Tix library
7

SYNOPSIS

9       tix option ?arg arg ...?
10

CONFIGURATION OPTIONS

12       This  manual  page  descripts  the  tix  command, which manipulates the
13       internal states of the Tix library. If you're  looking  for  a  general
14       introduction  to  the  Tix library, please refer to the TixIntro manual
15       page.
16
17       The  Tix  application  context  supports  the  following  configuration
18       options.  Usually, these options are set using the X resource database,
19       i.e., in the user's .Xdefault file. For example, to choose a  different
20       color  scheme  for the Tix widgets, these two lines can be added to the
21       user's .Xdefault file:
22              *TixScheme:  Gray *TixFontSet: 14Point
23       [-binding binding] This is an obsolete option.   [-debug debug]  Speci‐
24       fies  whether the Tix widgets should run in debug mode.  [-fontset tix‐
25       FontSet] Specifies the fontset  to  use  for  the  Tix  widgets.  Valid
26       options  are  WmDefault,  TK,  TkWin, 12Point and 14Point. TK specifies
27       that the standard TK fonts should be used. The default value  is  WmDe‐
28       fault.   [-scheme tixScheme]  Specifies the color scheme to use for the
29       Tix widgets. Valid  options  are  WmDefault,  TK,  TkWin,  Gray,  Blue,
30       Bisque,  SGIGray and TixGray. If you want the standard TK color scheme,
31       you can use the value TK.  The default value is WmDefault.
32        ' [-schemepriority tixSchemePriority] Specifies the priority level  of
33       the  TK options set by th Tix schemes. Please refer to the TK option(n)
34       manual page for a discussion of the priority level of Tix options.  The
35       default  value  is 79, which makes the Tix schemes at a higher priority
36       than the settings in the .Xdefaults file. If you want to allow the  Tix
37       schemes  to  be  overridden by the settings in the .Xdefaults file, you
38       can set the following line in you .Xdefaults file:  *TixSchemePriority:
39       21
40

DESCRIPTION

42       The  tix  command  provides  access  to miscellaneous elements of Tix's
43       internal state and the Tix application context.  Most of  the  informa‐
44       tion  manipulated  by  this  command  pertains  to the application as a
45       whole, or to a screen or display, rather than to a  particular  window.
46       The  command  can  take any of a number of different forms depending on
47       the option argument.  The legal forms are:
48
49       tix addbitmapdir directory
50              Tix maintains a list of directory  under  which  which  the  tix
51              getimage and tix getbitmap commands will search for image files.
52              The  standard  bitmap  directory  is  $TIX_LIBRARY/bitmaps.  The
53              addbitmapdir  command  adds  directory  into this list. By using
54              this command, the image files of an  applications  can  also  be
55              located using the tix getimage ot tix getbitmap command.
56
57       tix cget option
58              Returns  the  current value of the configuration option given by
59              option. Option may be any of the options described in  the  CON‐
60              FIGURATION OPTIONS section.
61
62       tix configure ?option? ?value option value ...?
63              Query or modify the configuration options of the Tix application
64              context. If no option is specified, returns  a  list  describing
65              all  of the available options (see Tk_ConfigureInfo for informa‐
66              tion on the format of this list).  If option is  specified  with
67              no  value,  then  the  command returns a list describing the one
68              named option (this list will be identical to  the  corresponding
69              sublist  of  the  value returned if no option is specified).  If
70              one or more option-value pairs are specified, then  the  command
71              modifies the given option(s) to have the given value(s); in this
72              case the command returns an empty string. Option may be  any  of
73              the options described in the CONFIGURATION OPTIONS section.
74
75       tix filedialog ?class?
76              Returns  the file selection dialog that may be shared among dif‐
77              ferent modules of this application. This command will  create  a
78              file  selection  dialog widget when it is called the first time.
79              This dialog will be returned by  all  subsequent  calls  to  tix
80              filedialog.  An optional class parameter can be passed to speci‐
81              fied what type of file selection dialog widget is desired.  Pos‐
82              sible options are tixFileSelectDialog or tixExFileSelectDialog.
83
84       tix getbitmap name
85              Locates a bitmap file of the name name.xpm or name in one of the
86              bitmap directories (see  the  addbitmapdir  command  above).  By
87              using tix getbitmap, you can advoid hard coding the pathnames of
88              the bitmap  files  in  your  application.  When  successful,  it
89              returns  the complete pathname of the bitmap file, prefixed with
90              the character @.  The returned value can be  used  to  configure
91              the -bitmap option of the TK and Tix widgets.
92
93       tix getimage name
94              Locates an image file of the name name.xpm, name.xbm or name.ppm
95              in one of the bitmap directories (see the  addbitmapdir  command
96              above).  If more than one file with the same name (but different
97              extensions) exist, then the image type is  chosen  according  to
98              the  depth of the X display: xbm images are chosen on monochrome
99              displays and color images are chosen on color displays. By using
100              tix  getimage,  you  can advoid hard coding the pathnames of the
101              image files in your application. When successful,  this  command
102              returns  the  name of the newly created image, which can be used
103              to configure the -image option of the TK and Tix widgets.
104
105       tix initstyle
106              Init the style defaults for Tix.  Prior to Tix 8.4 this was done
107              by  simply  package requiring Tix, but this call is now required
108              to explicitly use Tix style.
109
110       tix option ?args ...?
111              Manipulates the options manitained by the Tix scheme  mechanism.
112              Available  options  are:  active_bg    active_fg    bg bold_font
113              dark1_bg     dark1_fg  dark2_bg     dark2_fg     disabled_fg  fg
114              fixed_font   font  inactive_bg  inactive_fg  input1_bg input2_bg
115              italic_font   light1_bg   light1_fg     light2_bg      light2_fg
116              menu_font     output1_bg    output2_bg   select_bg     select_fg
117              selector The arguments to the tix option command  can  take  the
118              following form(s):
119
120              tix option get option
121                     Returns the current value of option.
122
123       tix resetoptions newScheme newFontSet ?newScmPrio?
124              Resets  the  scheme  and  fontset  of  the  Tix  application  to
125              newScheme and newFontSet, respectively. This affects only  those
126              widgets  created  after this call. Therefore, it is best to call
127              the resetoptions command before the creation of any widgets in a
128              Tix application.
129
130              The optional parameter newScmPrio can be given to reset the pri‐
131              ority level of the TK options set by the Tix schemes.
132

BUGS

134       [1]    In this release of Tix, the following configuration options have
135              been  disabled.  Assigning  values to them will cause no effect:
136              -binding -debug -fontset -scheme  -schemepriority  In  addition,
137              the  following  options  to  the tix command have been disabled.
138              Invoking the tix  command  with  these  options  will  cause  no
139              effect: resetoptions
140
141       [2]    Because  of  the  way  TK  handles  the X option database, after
142              tixwish has started up, it is not possible to  reset  the  color
143              schemes and font sets using the tix config command. Instead, the
144              tix resetoptions command must be used.
145
146       The tk_setPalette command does not work very well under Tix. To use it,
147       one must follow these steps:
148              tix resetoptions TK TK tk_setPalette lightblue
149

KEYWORDS

151       file selection dialog
152
153
154
155
156Tix                                   8.4                               tix(n)
Impressum