chooseDirectory.n
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
- '"
- '" Copyright (c) 1998-2000 by Scriptics Corporation.
- '" All rights reserved.
- '"
- '" RCS: @(#) $Id: chooseDirectory.n,v 1.1.10.1 2004/10/28 10:19:29 dkf Exp $
- '"
- .so man.macros
- .TH tk_chooseDirectory n 8.3 Tk "Tk Built-In Commands"
- .BS
- '" Note: do not modify the .SH NAME line immediately below!
- .SH NAME
- tk_chooseDirectory - pops up a dialog box for the user to select a directory.
- .PP
- .SH SYNOPSIS
- fBtk_chooseDirectory fR?fIoption value ...fR?
- .BE
- .SH DESCRIPTION
- .PP
- The procedure fBtk_chooseDirectoryfR pops up a dialog box for the
- user to select a directory. The following fIoption-valuefR pairs are
- possible as command line arguments:
- .TP
- fB-initialdirfR fIdirnamefR
- Specifies that the directories in fIdirectoryfR 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 fIGeneral ControlsfR
- control panel on the Mac allows the end user to override the
- application default directory.
- .TP
- fB-parentfR fIwindowfR
- Makes fIwindowfR the logical parent of the dialog. The dialog
- is displayed on top of its parent window.
- .TP
- fB-titlefR fItitleStringfR
- 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.
- .TP
- fB-mustexistfR fIbooleanfR
- 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 fIfalsefR.
- .SH EXAMPLE
- .CS
- set dir [fBtk_chooseDirectoryfR \
- -initialdir ~ -title "Choose a directory"]
- if {$dir eq ""} {
- label .l -text "No directory selected"
- } else {
- label .l -text "Selected $dir"
- }
- .CE
- .SH "SEE ALSO"
- tk_getOpenFile(n), tk_getSaveFile(n)
- .SH KEYWORDS
- directory, selection, dialog, platform-specific