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

FreeBSD Manual Pages


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

       tixDirList - Create and manipulate tixDirList widgets

       tixDirList pathName ?options?

       The TixDirList class is derived from the	TixScrolledHList class and in-
       herits all the commands,	options	and subwidgets of its super-class.

       TixDirList 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 directory (usually by single-clicking on the name  of  the
       directory). The command is called with one argument, the	complete path-
       name of the directory.  [-command command] Specifies the	command	to  be
       called when the user activates on a directory (usually by double-click-
       ing on the name of the directory). The command is called	with one argu-
       ment,  the complete pathname of the directory.  [-dircmd	dircmd]	Speci-
       fies the	TCL command to be called when a	directory  listing  is	needed
       for a particular	directory. If this option is not specified, by default
       the DirList widget will attempt to read the directory as	a Unix	direc-
       tory. On	special	occasions, the application programmer may want to sup-
       ply a special method for	reading	 directories:  for  example,  when  he
       needs  to list remote directories. In this case,	the -dircmd option can
       be used.	The specified command accepts two arguments: the first is  the
       name of the directory to	be listed; the second is a Boolean value indi-
       cating whether hidden sub-directories should be	listed.	 This  command
       returns	a  list	of names of the	sub-directories	of this	directory. For

       proc read_dir {dir show_hidden} {
	   if {$dir == "C:\"} {
	       return {DOS NORTON WINDOWS}
	   } else {
	       return {}
	   } } [-disablecallback disableCallback] 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
       DirList	widget	changes.   [-showhidden	showHidden]  Specifies whether
       hidden directories should be shown. By default, a directory name	start-
       ing  with  a  period "."	is considered as a hidden directory. This rule
       can  be	overridden  by	supplying  an  alternative   -dircmd   option.
       [-root root]  Specifies the name	of the root directory. Usually this is
       "/" under Unix machines,	but can	be changed to "C:\"  in	 DOS  environ-
       ments.	[-rootname rootName] Specifies a text string to	display	at the
       root directory. If unspecified, the text	string will be the same	as the
       string specified	by -root.

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

	      Specifies	 the  name of the current directory to be displayed in
	      the DirList widget.

       Name:	      hlist
       Class:	      TixHList

	      The hierarchical listbox that displays the directory listing.

       Name:	      hsb
       Class:	      Scrollbar

	      The horizontal scrollbar subwidget.

       Name:	      vsb
       Class:	      Scrollbar

	      The vertical scrollbar subwidget.

       The tixDirList command creates a	new window (given by the pathName  ar-
       gument)	and  makes  it into a DirList widget.  Additional options, de-
       scribed above, may be specified on the command line or  in  the	option
       database	to configure aspects of	the DirList such as its	cursor and re-

       The DirList widget displays a list view of a  directory,	 its  previous
       directories and its sub-directories. The	user can choose	one of the di-
       rectories displayed in the list or change to another directory.

       The tixDirList command creates a	new Tcl	command	whose name is the same
       as  the path name of the	DirList's window.  This	command	may be used to
       invoke various operations on the	widget.	It has the  following  general
	      pathName option ?arg arg ...?
       PathName	 is  the name of the command, which is the same	as the DirList
       widget's	path name. Option and the args determine the exact behavior of
       the command. The	following commands are possible	for DirList 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
	      tixDirList command.

       pathName	chdir dir
	      Change the current directory to dir.

       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 tixDirList command.

       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.

       The  mouse  and keyboard	bindings of the	DirList	widget are the same as
       the bindings of the HList widget.


Tix				      4.0			 tixDirList(n)


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

home | help