home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l460 / 2.ddi / GRAPHICS.DI$ / UIGETFIL.M < prev    next >
Encoding:
Text File  |  1993-03-07  |  1.4 KB  |  34 lines
  1. %UIGETFILE Interactively retrieve a filename by displaying a dialog box.
  2. %    [FILENAME, PATHNAME] = UIGETFILE('filterSpec', 'dialogTitle', X, Y)
  3. %    displays a dialog box for the user to fill in, and returns the
  4. %    filename and path strings.  A successful return occurs only if
  5. %    the file exists.  If the user selects a file that does not exist,
  6. %    an error message is displayed, and control returns to the dialog box.
  7. %    The user may then enter another filename, or press the Cancel button. 
  8. %
  9. %    All parameters are optional, but if one is used, all previous 
  10. %    parameters must also be used.
  11. %
  12. %    The filterSpec parameter determines the initial display of files in 
  13. %    the dialog box.  For example '*.m' lists all the MATLAB M-files.
  14. %
  15. %    Parameter 'dialogTitle' is a string containing the title of the dialog
  16. %    box.
  17. %
  18. %    The X and Y parameters define the initial position of the dialog
  19. %    box in units of pixels.  Some systems may not support this option.
  20. %
  21. %    The output variable FILENAME is a string containing the name of the 
  22. %    file selected in the dialog box.  If the user presses the Cancel button
  23. %    or if any error occurs, it is set to 0.
  24. %
  25. %    The output parameter PATHNAME is a string containing the path of
  26. %    the file selected in the dialog box.  If the user presses the Cancel
  27. %    button or if any error occurs, it is set to 0.
  28. % 
  29. %    See also UIPUTFILE.
  30.  
  31. %    Copyright (c) 1984-93 by The MathWorks, Inc.
  32. %    Built-in function.
  33.  
  34.