home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / tsw / TSW_3.4.0.exe / Apache2 / perl / chooseDirectory.pod < prev    next >
Encoding:
Text File  |  2003-08-16  |  1.7 KB  |  61 lines
  1. #  Copyright (c) 1998-2000 by Scriptics Corporation.
  2. #  All rights reserved.
  3. #
  4. #  RCS: @(#) $Id: chooseDirectory.n,v 1.1 2000/01/27 00:23:10 ericm Exp $
  5. #
  6.  
  7. =head1 NAME
  8.  
  9. tk_chooseDirectory - pops up a dialog box for the user to select a directory.
  10.  
  11. =for category  Tk Generic Methods
  12.  
  13. =head1 SYNOPSIS
  14.  
  15. B<tk_chooseDirectory >?I<option value ...>?
  16.  
  17. =head1 DESCRIPTION
  18.  
  19. The procedure B<tk_chooseDirectory> pops up a dialog box for the
  20. user to select a directory. The following I<option-value> pairs are
  21. possible as command line arguments:
  22.  
  23. =over 4
  24.  
  25. =item B<-initialdir> I<dirname>
  26.  
  27. Specifies that the directories in I<directory> should be displayed
  28. when the dialog pops up. If this parameter is not specified, then
  29. the directories in the current working directory are displayed. If the
  30. parameter specifies a relative path, the return value will convert the
  31. relative path to an absolute path.  This option may not always work on
  32. the Macintosh.  This is not a bug. Rather, the I<General Controls>
  33. control panel on the Mac allows the end user to override the
  34. application default directory.
  35.  
  36. =item B<-parent> $widget
  37.  
  38. Makes $widget the logical parent of the dialog. The dialog
  39. is displayed on top of its parent window.
  40.  
  41. =item B<-title> I<titleString>
  42.  
  43. Specifies a string to display as the title of the dialog box. If this
  44. option is not specified, then a default title will be displayed.
  45.  
  46. =item B<-mustexist> I<boolean>
  47.  
  48. Specifies whether the user may specify non-existant directories.  If
  49. this parameter is true, then the user may only select directories that
  50. already exist.  The default value is I<false>.
  51.  
  52. =back
  53.  
  54. =head1 SEE ALSO
  55.  
  56. L<Tk::getOpenFile>, L<Tk::getOpenFile>
  57.  
  58. =head1 KEYWORDS
  59.  
  60. directory selection dialog
  61.