Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
tix(n)			     Tix Built-In Commands			tix(n)

NAME
       tix - Manipulate	internal states	of the Tix library

SYNOPSIS
       tix option ?arg arg ...?

CONFIGURATION OPTIONS
       This  manual  page descripts the	tix command, which manipulates the in-
       ternal states of	the Tix	library. If you're looking for a  general  in-
       troduction  to  the  Tix	 library,  please refer	to the TixIntro	manual
       page.

       The Tix application context supports the	 following  configuration  op-
       tions.  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]	Speci-
       fies  whether the Tix widgets should run	in debug mode.	[-fontset tix-
       FontSet]	Specifies the fontset to use for the Tix  widgets.  Valid  op-
       tions  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 wid-
       gets. 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

DESCRIPTION
       The  tix	command	provides access	to miscellaneous elements of Tix's in-
       ternal 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  com-
       mand  can  take any of a	number of different forms depending on the op-
       tion 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  ad-
	      dbitmapdir  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  CON-
	      FIGURATION 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 informa-
	      tion 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 dif-
	      ferent 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	speci-
	      fied what	type of	file selection dialog widget is	desired.  Pos-
	      sible 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  us-
	      ing  tix	getbitmap, you can advoid hard coding the pathnames of
	      the bitmap files in your application. When  successful,  it  re-
	      turns  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   se-
	      lector 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  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 pri-
	      ority 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. In-
	      voking 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

Tix				      8.4				tix(n)

NAME | SYNOPSIS | CONFIGURATION OPTIONS | DESCRIPTION | BUGS | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tix&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help