tix(n) Tix (4.0) tix(n)
_________________________________________________________________
NAME
tix - Manipulate Tix internal state
SYNOPSIS
tix option ?arg arg ...?
CONFIGURATION OPTIONS
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
Name: binding
Class: Binding
Switch: -binding
This is an obsolete option.
Name: debug
Class: Debug
Switch: -debug
Specifies whether the Tix widgets should run in debug
mode.
Name: tixFontSet
Class: TixFontSet
Switch: -fontset
Specifies the fontset to use for the Tix widgets. Valid
options are TK, 12Point and 14Point. TK specifies that
the standard TK fonts should be used. The default value
is 14Point.
Name: tixScheme
Class: TixScheme
Switch: -scheme
Specifies the color scheme to use for the Tix widgets.
Valid options are TK, 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 3.6 bisque color scheme, you can
use the value Bisque.
Page 1 (printed 12/22/98)
tix(n) Tix (4.0) tix(n)
Name: tixSchemePriority
Class: TixSchemePriority
Switch: -schemepriority
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 ot 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
Page 2 (printed 12/22/98)
tix(n) Tix (4.0) tix(n)
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 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
Page 3 (printed 12/22/98)
tix(n) Tix (4.0) tix(n)
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
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
Page 4 (printed 12/22/98)