%UIGETFILE Standard open file dialog box.
%   [FILENAME, PATHNAME] = UIGETFILE(FILTERSPEC, TITLE)
%   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. 
%
%   The FILTERSPEC parameter determines the initial display of files in 
%   the dialog box.  For example '*.m' lists all the MATLAB M-files.  If
%   FILTERSPEC is a cell array, the first column is used as the list of
%   extentions, and the second column is used as the list of descriptions.
%
%   When FILTERSPEC is a string, "All files (*.*)" is appended to the list,
%   nothing is appended when FILTERSPEC is a cell array.
%
%   When filterspec is empty the default list of file types is used.  See
%   example 2 below.
%
%   Parameter TITLE is a string containing the title of the dialog
%   box.
%
%   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.
% 
%   [FILENAME, PATHNAME] = UIGETFILE(FILTERSPEC, TITLE, X, Y)
%   places the dialog box at screen position [X,Y] in pixel units.
%   Not all systems support this option.
%
%   Examples:
%
%   [filename, pathname] = uigetfile('*.m', 'Pick an M-file');
%
%   [filename, pathname] = uigetfile( ...
%      {'*.m;*.fig;*.mat;*.mdl', 'All MATLAB Files (*.m, *.fig, *.mat, *.mdl)';
%       '*.m',  'M-files (*.m)'; ...
%       '*.fig','Figures (*.fig)'; ...
%       '*.mat','MAT-files (*.mat)'; ...
%       '*.mdl','Models (*.mdl)'; ...
%       '*.*',  'All Files (*.*)'}, ...
%       'Pick a file');
%
%   Note, multiple extensions with no descriptions must be separated by semi-
%   colons.
%
%   [filename, pathname] = uigetfile( ...
%      {'*.m';'*.mdl';'*.mat';'*.*'}, ...
%       'Pick a file');
%
%   Associate multiple extensions with one description like this:
%
%   [filename, pathname] = uigetfile( ...
%      {'*.m;*.fig;*.mat;*.mdl', 'All MATLAB Files (*.m, *.fig, *.mat, *.mdl)'; ...
%       '*.*',                   'All Files (*.*)'}, ...
%       'Pick a file');
%
%   This code checks for the existence of the file and returns a message 
%   about the success or failure of the open operation.
%
%   [filename, pathname] = uigetfile('*.m', 'Pick an M-file');
%   if isequal(filename,0)|isequal(pathname,0)
%      disp('File not found')
%   else
%      disp(['File ', pathname, filename, ' found'])
%   end
%
%
%   See also UIPUTFILE.

%   Copyright 1984-2000 The MathWorks, Inc. 
%   $Revision: 5.11 $  $Date: 2000/07/30 12:50:35 $
%   Built-in function.

