UIGETFILE

 

 Interactively retrieve a filename by displaying a dialog box.

  [FILENAME, PATHNAME] = UIGETFILE('filterSpec', '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 exists.  If the user selects a file that does not exist,

  an error message is displayed, and control returns 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 filterSpec parameter determines the initial display of files in 

  the dialog box.  For example '*.m' lists all the 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.  Some systems may not 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 parameter PATHNAME is a string containing the path 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.

 

 

  See also UIPUTFILEG0JT3Q.