UIPUTFILE

 

 Interactively retrieve a filename by displaying a dialog box.

  [FILENAME, PATHNAME] = UIPUTFILE('initFile', 'dialogTitle', X, Y)

  displays a dialog box for the user to fill in, and returns the

  filename and path strings.  A successful return occurs only if

  the file does not exist or if the user has given explicit permission

  to delete the file.

 

 

  If the user selects a file that exists, a prompt is issued asking 

  whether the user wishes to delete the file.  A 'YES' response 

  successfully returns but does NOT delete the file (which is the 

  responsibility of the calling routine).  A 'NO' response will 

  simply return control back to the dialog box. The user may then 

  enter another filename, or press the Cancel button. 

 

 

  All parameters are optional, but if one is used, all previous 

  parameters must also be used.

 

 

  The initFile parameter determines the initial display of files 

  in the dialog box.  Full file name specifications as well as wildcards

  are allowed.  For example, 'newfile.m' initializes the display to

  that particular file and lists all other existing.m files.  This may

  be used to provide a default file name.  A wildcard specification such

  as '*.m' lists all the existing MATLAB M-files.

 

 

  Parameter 'dialogTitle' is a string containing the title of the dialog

  box.

 

 

  The X and Y parameters define the initial position of the dialog

  box in units of pixels.  Not all systems may support this option.

 

 

  The output variable FILENAME is a string containing the name of the

  file selected in the dialog box.  If the user presses the Cancel button

  or if any error occurs, it is set to 0.

 

 

  The output variable PATH1BK5GU2 is a string containing the name of the path

  selected in the dialog box.  If the user presses the Cancel button 

  or if any error occurs, it is set to 0.

 

 

  Example:

      [newmatfile, newpath] = uiputfile('*.mat', 'Save As');

 

 

  See also UIGETFILE2JFT2K5.