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

FreeBSD Manual Pages


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

       tixExFileSelectBox - Create and manipulate tixExFileSelectBox widgets

       tixExFileSelectBox pathName ?options?

       The TixExFileSelectBox class does not have a super-class.

       TixExFileSelectBox supports all the standard options of a frame widget.
       See the options(n) manual entry for details on the standard options.

       [-browsecmd browseCmd] Specifies	a command to call  whenever  the  user
       browses	on  a filename in the file listbox (usually by single-clicking
       on the filename). The command is	called with one	argument, the complete
       pathname	 of  the file.	[-command command] Specifies the command to be
       called when the user chooses on a filename the file listbox (usually by
       double-clicking	on the filename). The command is called	with one argu-
       ment, the complete pathname of the file.	 [-dialog dialog] Specifies  a
       dialog  box  which contains this	ExFileSelectBox	widget.	The dialog box
       must be a widget	of the class TixShell or its descendant	classes.  This
       is  an  internal	 option	and should not be used by application program-
       mers.  [-dircmd dircmd] Specifies the TCL command to be called  when  a
       file  listing  is  needed for a particular directory. If	this option is
       not specified, by default the ExFileSelectBox widget  will  attempt  to
       read  the  directory as a Unix directory. On special occasions, the ap-
       plication programmer may	want to	supply a special  method  for  reading
       directories:  for  example, when	he needs to list remote	files. In this
       case, the -dircmd option	can be used.  The  specified  command  accepts
       three  arguments:  the first is the name	of the directory to be listed;
       the second is a list of file patterns, the third	is a Boolean value in-
       dicating	 whether hidden	files should be	listed.	This command returns a
       list of names of	the files of this directory which match	with the  file

       Name:	      directory
       Class:	      Directory
       Switch:	      -directory
       Alias:	      -dir

	      Specifies	 the current directory whose files and sub-directories
	      are displayed in	the  ExFileSelectBox.	[-disablecallback dis-
	      ableCallback]  A	boolean	 value	indicating  whether  callbacks
	      should be	disabled. When set to true, the	TCL command  specified
	      by  the  -command	 option	is not executed	when the -value	of the
	      ExFileSelectBox widget changes.	[-filetypes fileTypes]	Speci-
	      fies the file types that can be selected from the	"List Files of
	      Type:" ComboBox subwidget. The value of this option  must	 be  a
	      TCL  list;  each item of this list must in turn be a list	of two
	      elements.	 The first element is a	list  of  file	patterns.  The
	      second  element  is  a string that describe these	file patterns.
	      For example:
		  tixExFileSelectBox .box -filetypes  {
		      {{*}   {All files}}
		      {{*.txt}	  {Text	files}}
		      {{*.c *.h}  {C source files}}
	      [-showhidden showHidden] Specifies  whether  hidden  directories
	      should  be  shown.  By default, a	directory name starting	with a
	      period "." is considered as a hidden directory.	[-pattern pat-
	      tern]  Specifies	whether	 the file pattern(s) to	match with the
	      files in the current directory. One or more file patterns	can be
	      given  at	 the  same time. For example, {*.c *.h}	will match all
	      files that have either the ".h" or ".c" extensions.

       Name:	      value
       Class:	      Value
       Switch:	      -value
       Alias:	      -selection

	      Specifies	the name of the	filename  currently  selected  by  the

       Name:	      cancel
       Class:	      Button

	      The button widget	with the "Cancel" label.

       Name:	      dir
       Class:	      TixComboBox

	      The ComboBox subwidget under the "Directories" heading.

       Name:	      dirlist
       Class:	      TixDirList

	      The DirList subwidget that shows the hierarchical	list of	direc-

       Name:	      file
       Class:	      TixComboBox

	      The ComboBox subwidget under the "Files" heading.

       Name:	      filelist
       Class:	      TixScrolledListBox

	      The ScrolledListBox subwidget that shows the list	of filenames.

       Name:	      hidden
       Class:	      Checkbutton

	      The checkbutton widget with the "Show Hidden Files" label.

       Name:	      ok
       Class:	      Button

	      The button widget	with the "OK" label.

       Name:	      types
       Class:	      TixComboBox

	      The ComboBox subwidget under the "List Files of Type" heading.

       The tixExFileSelectBox command creates a	new window (given by the path-
       Name  argument)	and makes it into a ExFileSelectBox widget. Additional
       options,	described above, may be	specified on the command  line	or  in
       the option database to configure	aspects	of the ExFileSelectBox such as
       its cursor and relief.

       The ExFileSelectBox widget is usually embedded in a tixExFileSelectDia-
       log  widget.  It	 provides  an convenient method	for the	user to	select
       files. The style	of the ExFileSelectBox widget is very similar  to  the
       standard	file dialog in MS Windows 3.1.

       The  tixExFileSelectBox command creates a new Tcl command whose name is
       the same	as the path name of the	ExFileSelectBox's window. This command
       may be used to invoke various operations	on the widget. It has the fol-
       lowing general form:
	      pathName option ?arg arg ...?
       PathName	is the name of the command, which is the same as the ExFileSe-
       lectBox widget's	path name. Option and the args determine the exact be-
       havior of the command. The following commands are possible for ExFileS-
       electBox	widgets:

       pathName	cget option
	      Returns  the  current value of the configuration option given by
	      option. Option may have any of the values	accepted by the	tixEx-
	      FileSelectBox command.

       pathName	configure ?option? ?value option value ...?
	      Query  or	modify the configuration options of the	widget.	 If no
	      option is	specified, returns a list describing all of the	avail-
	      able  options for	pathName (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  widget option(s) to have the given value(s); in this
	      case the command returns an empty	string.	 Option	may  have  any
	      of the values accepted by	the tixExFileSelectBox command.

       pathName	filter
	      Forces the ExFileSelectBox widget	to re-filter all the filenames
	      according	to the -pattern	option.

       pathName	invoke
	      Forces the ExFileSelectBox widget	to perform actions as  if  the
	      user has pressed the "OK"	button.

       pathName	subwidget  name	?args?
	      When  no options are given, this command returns the pathname of
	      the subwidget of the specified name.

	      When options are given, the widget command of the	specified sub-
	      widget will be called with these options.


Tix				      4.0		 tixExFileSelectBox(n)


Want to link to this manual page? Use this URL:

home | help