opensolaris man page for tk_choosedirectory

tk_chooseDirectory(1T)					       Tk Built-In Commands					    tk_chooseDirectory(1T)

__________________________________________________________________________________________________________________________________________________

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

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 displayed. If the parameter specifies a relative path, the return value will
	      convert the relative path to an absolute path.  This option may not always work on the Macintosh.  This is not a	bug.  Rather,  the
	      General Controls control panel on the Mac allows the end user to override the application default directory.

       -parent window
	      Makes window the logical parent of the dialog. The dialog is displayed on top of its 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.

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

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(1T), tk_getSaveFile(1T)

KEYWORDS
       directory, selection, dialog, platform-specific

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tk is available on http://opensolaris.org.

Tk									8.3						    tk_chooseDirectory(1T)