Tk Built-In Commands                       tkchooseDirectory(1T)





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

SYNOPSIS
     tkchooseDirectory ?option value ...?



DESCRIPTION
     The procedure tkchooseDirectory 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  con-
          vert  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 applica-
          tion default directory.

     -parent window
          Makes window the logical parent of the dialog. The dia-
          log is displayed on top of its parent window.

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

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

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




Tk                      Last change: 8.3                        1






Tk Built-In Commands                       tkchooseDirectory(1T)



SEE ALSO
     tkgetOpenFile(1T), tkgetSaveFile(1T)

KEYWORDS
     directory, selection, dialog, platform-specific

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTk         
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for Tk is available on http:/opensolaris.org.



































Tk                      Last change: 8.3                        2