Manual Pages for UNIX Operating System command usage for man tk_chooseDirectory

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  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 [tk_chooseDirectory \
                  -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                       tk_chooseDirectory(1T)



SEE ALSO
     tk_getOpenFile(1T), tk_getSaveFile(1T)

KEYWORDS
     directory, selection, dialog, platform-specific

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

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tk-8   |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

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



































Tk                      Last change: 8.3                        2