This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

tk_chooseDirectory(n)                       Tk Built-In Commands                       tk_chooseDirectory(n)



____________________________________________________________________________________________________________

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 follow-ing following
       ing 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 rela-tive relative
              tive 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 displayed.

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



SEE ALSO
       tk_getOpenFile, tk_getSaveFile


KEYWORDS
       directory selection dialog



Tk                                                   8.3                               tk_chooseDirectory(n)