MATLAB 利用GUIDE设计GUI时，M文件中函数结构以及功能

GUI文件由.fig图窗文件和.m文件组成

其中.fig文件主要时界面的布局设计，提供了一种更加方便的设计方式
.m文件是GUI的核心，当创建.fig文件后就会自动的生成配套的.m文件
.m文件一共由4部分组成:主函数 Opening函数 Output函数 回调函数

主函数

如下(请仔细看注解,gui9201是主函数名,我随便写的)

function varargout = gui9201(varargin)
%% ----------------------------------------------------------------------------% 
%   varargin：输入参数     varargout：输出参数      gui9201：函数名
%   当创建GUI时，varargin为空
%   当触发GUI对象时，varargin为一个1X4的元胞数组{xxx xxx xxx xxx}
%   varargin{1}是要执行的回调函数的函数名
%   varargin{2}、varargin{3}、varargin{4}是输入到回调函数的参数，分别代表
%   hObject（当前回调函数对应的GUI对象句柄）
%   eventdata（附加参数）
%   handles（当前GUI所有数据的结构体，包含所有GUI对象的句柄和用户定义的数据）
%------------------------------------------------------------------------------%

% Begin initialization code - DO NOT EDIT
%% ----------------------------------------------------------------------------%
%   gui_Singleton = 1;表示GUI只能产生一个窗口实例
%------------------------------------------------------------------------------%
gui_Singleton = 1;

%% ----------------------------------------------------------------------------%
%   结构体gui_State共有6个字段
%   字段名'gui_Name',值为mfilename，作用是函数mfilename返回正在运行的M文件的名字
%   字段名'gui_Singleton'，设置是否只创建一个GUI实例
%   字段名'gui_OpeningFcn'，值为OpeningFcn函数的句柄 @gui9201_OpeningFcn
%   字段名'gui_OutputFcn'，值为OutPutFcn函数的句柄 @gui9201_OutputFcn
%   字段名'gui_LayoutFcn'，用于创建GUI实例；值为空时，先检查上次的GUI初始化是否完成
%   若没有完成，则删除上次创建的句柄并重新创建
%   字段名'gui_Callback' ，值为空，表示只运行OpeningFcn和OutputFcn，不运行Callback
%------------------------------------------------------------------------------%
gui_State = struct('gui_Name',       mfilename, ...
                   'gui_Singleton',  gui_Singleton, ...
                   'gui_OpeningFcn', @gui9201_OpeningFcn, ...
                   'gui_OutputFcn',  @gui9201_OutputFcn, ...
                   'gui_LayoutFcn',  [] , ...
                   'gui_Callback',   []);
               
%% ---------------------------------------------------------------------------%
%   用于设置gui_State.gui_Callback的值，该值将用于判断是创建GUI还是执行回调函数
%   若存在输入参数，且第一个输入参数是字符串，则将该字符串表示的回调函数设置为gui_Ca
%   llback的值
%   若没有输入参数，则字段'gui_Callback'的值为空
%------------------------------------------------------------------------------%
if nargin && ischar(varargin{1})
    gui_State.gui_Callback = str2func(varargin{1});
end

%% ---------------------------------------------------------------------------%
%   关于运行GUI默认的处理函数 gui_mainfcn，该函数处理GUI创建、GUI布局和回调函数
%   当输出参数存在时，输出参数是gui_mainfcn的返回值
%   当输出参数不存在时，直接运行gui_mainfcn
%------------------------------------------------------------------------------%
%   gui_State.gui_Callback已经在line42~line44设置好了，这里做出处理
%   gui_mainfcn函数是GUI默认的处理函数根据gui_State和传入的参数确定执行回调函数还是
%   打开GUI并执行OpeningFcn和OutputFcn
%   若gui_State.gui_Callback为空，那么就运行GUI，打开窗口fig文件，也即弹出GUI界面
%   若gui_State.gui_Callback不空，表示这是操作ui对象的结果，也即需要执行gui_Callba
%   ck所指定的子函数
%------------------------------------------------------------------------------%
if nargout
    [varargout{1:nargout}] = gui_mainfcn(gui_State, varargin{:});
else
    gui_mainfcn(gui_State, varargin{:});
end
% End initialization code - DO NOT EDIT
%% --总之：当运行某个GUI文件，其运行机制如下：------------------------------------%
%   1.刚运行GUI时，varargin参数为空，gui_State进行初始化，如line29~line34
%   2.之后根据参数（此时参数为空），gui_State.gui_Callback为空，如line42~line44
%   3.因为gui_State.gui_Callback为空，所以程序创建GUI，也即弹出GUI界面
%   4.创建GUI的顺序为：创建handles结构体--->运行OpeningFcn函数--->GUI窗口显现
%   如果是响应某个UI对象
%   1.varargin参数是1x4的元胞数组
%   2.gui_State.gui_Callback被设置为回调函数句柄
%   3.根据gui_State.gui_Callback不为空，则程序知道是要执行回调函数
%   4.varargin{2}、varargin{3}、varargin{4}作为参数输入到回调函数
%------------------------------------------------------------------------------%

Opening函数

function gui9201_OpeningFcn(hObject, eventdata, handles, varargin)
%%   运行于GUI开始执行但是还不可见的时候
%    主要任务是初始化操作
% This function has no output args, see OutputFcn.
% hObject    handle to figure
% eventdata  reserved - to be defined in a future version of MATLAB
% handles    structure with handles and user data (see GUIDATA)
% varargin   主函数gui9201的所有输入参数，类型是单元数组

% 将窗口对象的句柄hObject存入handles的output字段中去
handles.output = hObject;

% 将handles保存在hObject所在的窗口中，作为新的GUI数据，起到更新handles的左右
guidata(hObject, handles);

% 通过添加uiwait暂停M文件输出，等待uiresume继续文件执行，可以在中间这个过程在期待的
% 回调函数中，更新handles.output数据
% UIWAIT makes gui9201 wait for user response (see UIRESUME)
% uiwait(handles.figure1);

Output函数

function varargout = gui9201_OutputFcn(hObject, eventdata, handles) 
%%   输出数据到命令行
% varargout  cell array for returning output args (see VARARGOUT);
% hObject    handle to figure
% eventdata  reserved - to be defined in a future version of MATLAB
% handles    structure with handles and user data (see GUIDATA)

% 默认是一个输出，也可以主动添加其他输出
varargout{1} = handles.output; 

回调函数Callback

GUIDE方式编写GUI时,所有的Callback函数的参数都必须要有3个输入参数 hObject,eventdata, handles
举个例子

function volume_Callback(hObject, eventdata, handles)
% hObject    handle to volume (see GCBO)
% eventdata  reserved - to be defined in a future version of MATLAB
% handles    structure with handles and user data (see GUIDATA)

% Hints: get(hObject,'String') returns contents of volume as text
%        str2double(get(hObject,'String')) returns contents of volume as a double
volume = str2double(get(hObject, 'String'));
if isnan(volume)
    set(hObject, 'String', 0);
    errordlg('Input must be a number','Error');
end

% Save the new volume value
handles.metricdata.volume = volume;
guidata(hObject,handles)

回调函数的回调格式(假设主函数 是gui9201)

gui9201('volume_Callback',hObject,eventdata,handles)
// 注意:这个过程是,你在.fig界面操作某对象后,会将一个元胞数组(里面是输入参数),送去.m文件执行
// 这个执行的过程就如上述语句,运行了gui0902.m函数,带着这些参数进到gui0902.m函数中后,经过函数
// 的识别机制(前面讲过了),.m文件就知道了是要执行回调函数的,于是就对你在.fig界面的操作做出了响应

要理清楚的一个思路

1 .m文件并不是一直都在执行,刚刚开始打开GUI的时候,
.m文件执行一次,因为刚刚开始执行的时候
输入参数varagrout是空,形式如gui9201().
所以.m内部机制识别出来需要打开GUI界面,弹出GUI界面
2 当打开GUI界面后,我们对界面上的控件进行操.fig
你操作的信息传回.m文件
以gui9201(‘volume_Callback’,hObject,eventdata,handles)这种形式执行
同样的.m内部即使识别出是要执行回调函数volume_Callback
于是将hObject,eventdata,handles作为回调函数的参数进行执行
3 上次执行完之后,如果再次操作某控件,就会循环上述触发回调
这其中也有回调是否允许被中断等小问题
4 .m文件的执行顺序(可以理解为在主函数中调来调去其他子函数的一个过程)
主函数---->在主函数中进行初步的初始化—>主函数中调用gui_mainfun()—>
在gui_mainfun()中创建handles—>然后在其中调用Opening函数—>显示窗口对象—>
执行Output函数—>程序结束(此时显示为fig界面,用户可以进行操作)