home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l460 / 2.ddi / GRAPHICS.DI$ / UIPUTFIL.M < prev    next >
Encoding:
Text File  |  1993-03-07  |  2.0 KB  |  47 lines
  1. %UIPUTFILE Interactively retrieve a filename by displaying a dialog box.
  2. %    [FILENAME, PATHNAME] = UIPUTFILE('initFile', '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 does not exist or if the user has given explicit permission
  6. %    to delete the file.
  7. %
  8. %    If the user selects a file that exists,    a prompt is issued asking 
  9. %    whether the user wishes to delete the file.  A 'YES' response 
  10. %    successfully returns but does NOT delete the file (which is the 
  11. %    responsibility of the calling routine).  A 'NO' response will 
  12. %    simply return control back to the dialog box. The user may then 
  13. %    enter another filename, or press the Cancel button. 
  14. %
  15. %    All parameters are optional, but if one is used, all previous 
  16. %    parameters must also be used.
  17. %
  18. %    The initFile parameter determines the initial display of files 
  19. %    in the dialog box.  Full file name specifications as well as wildcards
  20. %    are allowed.  For example, 'newfile.m' initializes the display to
  21. %    that particular file and lists all other existing.m files.  This may
  22. %    be used to provide a default file name.  A wildcard specification such
  23. %    as '*.m' lists all the existing MATLAB M-files.
  24. %
  25. %    Parameter 'dialogTitle' is a string containing the title of the dialog
  26. %    box.
  27. %
  28. %    The X and Y parameters define the initial position of the dialog
  29. %    box in units of pixels.  Not all systems may support this option.
  30. %
  31. %    The output variable FILENAME is a string containing the name of the
  32. %    file selected in the dialog box.  If the user presses the Cancel button
  33. %    or if any error occurs, it is set to 0.
  34. %
  35. %    The output variable PATH is a string containing the name of the path
  36. %    selected in the dialog box.  If the user presses the Cancel button 
  37. %    or if any error occurs, it is set to 0.
  38. %
  39. %    Example:
  40. %        [newmatfile, newpath] = uiputfile('*.mat', 'Save As');
  41. % 
  42. %    See also UIGETFILE.
  43.  
  44. %    Copyright (c) 1984-93 by The MathWorks, Inc.
  45. %    Built-in function.
  46.  
  47.