Home Man
Today's Posts

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

RedHat 9 (Linux i386) - man page for tixdirlist (redhat section n)

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 inherits all the com-
       mands, 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 direc-
       tory (usually by single-clicking on the name of the directory). The command is called with
       one  argument,  the  complete pathname of the directory.  [-command command] Specifies the
       command to be called when the user activates on a directory (usually by double-clicking on
       the name of the directory). The command is called with one argument, the complete pathname
       of the directory.  [-dircmd dircmd] Specifies the TCL command to be called when	a  direc-
       tory  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 directory. On spe-
       cial occasions, the application programmer may want to supply 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 indicating whether  hid-
       den  sub-directories  should  be  listed. This command returns a list of names of the sub-
       directories of this directory. For example:

	      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 exe-
       cuted when the -value of the DirList widget changes.   [-showhidden showHidden]	Specifies
       whether	hidden	directories should be shown. By default, a directory name starting 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  environments.
       [-rootname rootName] Specifies a text string to display at the root directory. If unspeci-
       fied, 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 argument) and makes  it
       into  a DirList widget.	Additional options, described above, may be specified on the com-
       mand line or in the option database to configure aspects of the DirList such as its cursor
       and relief.

       The  DirList  widget displays a list view of a directory, its previous directories and its
       sub-directories. The user can choose one of the	directories  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 form:
		     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  speci-
	      fied,  returns  a  list  describing  all of the available options for pathName (see
	      Tk_ConfigureInfo for information on the format of this list).  If option is  speci-
	      fied 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 subwidget 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)

All times are GMT -4. The time now is 01:48 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
Show Password