1tix(n) Tix Built-In Commands tix(n)
2
3
4
6 tix - Manipulate internal states of the Tix library
7
9 tix option ?arg arg ...?
10
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
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
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
151 file selection dialog
152
153
154
155
156Tix 8.4 tix(n)