Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tk_chooseDirectory (1t)

Name

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

Synopsis

tk_chooseDirectory ?option value ...?

Description

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, the
              initial directory defaults to the current working  directory  on
              non-Windows  systems  and on Windows systems prior to Vista.  On
              Vista and later systems, the initial directory defaults  to  the
              last user-selected directory for the application. If the parame-
              ter 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"
              }


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       tk_getOpenFile(n), tk_getSaveFile(n)

KEYWORDS
       directory, selection, dialog, platform-specific



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                    8.3               tk_chooseDirectory(1t)