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

FreeBSD Manual Pages

  
 
  

home | help
tk_chooseDirectory(n)	     Tk	Built-In Commands	 tk_chooseDirectory(n)

______________________________________________________________________________

NAME
       tk_chooseDirectory  - pops up a dialog box for the user to select a di-
       rectory.

SYNOPSIS
       tk_chooseDirectory ?option value	...?
______________________________________________________________________________

DESCRIPTION
       The procedure tk_chooseDirectory	pops up	a dialog box for the  user  to
       select  a  directory.  The following option-value pairs are possible as
       command line arguments:

       -initialdir dirname
	      Specifies	that the directories in	directory should be  displayed
	      when  the	 dialog	 pops  up. If this parameter is	not specified,
	      then the directories in the current working directory  are  dis-
	      played.  If  the parameter specifies a relative path, the	return
	      value will convert the relative path to an absolute path.

       -mustexist boolean
	      Specifies	whether	the user may specify non-existent directories.
	      If  this parameter is true, then the user	may only select	direc-
	      tories that already exist.  The default value is false.

       -parent window
	      Makes window the logical parent of the  dialog.  The  dialog  is
	      displayed	 on  top of its	parent window. On Mac OS X, this turns
	      the file dialog into a sheet attached to the parent window.

       -title titleString
	      Specifies	a string to display as the title of the	dialog box. If
	      this  option is not specified, then a default title will be dis-
	      played.

EXAMPLE
	      set dir [tk_chooseDirectory \
		      -initialdir ~ -title "Choose a directory"]
	      if {$dir eq ""} {
		 label .l -text	"No directory selected"
	      }	else {
		 label .l -text	"Selected $dir"
	      }

SEE ALSO
       tk_getOpenFile(n), tk_getSaveFile(n)

KEYWORDS
       directory, selection, dialog, platform-specific

Tk				      8.3		 tk_chooseDirectory(n)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | SEE ALSO | KEYWORDS

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

home | help