tix - Manipulate internal states of the Tix library
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
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 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.
- [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