MATLAB GUI - Creating a Reset Button Part II

11 Jul 2008 Quan Quach 19 comments 2,669 views

Introduction

In the previous Reset Button tutorial, we discussed how to create a reset button. In this tutorial, we will discuss a different approach to creating a reset button. There are pros and cons to both methods, and we’ll go over those in a bit.

In the previous tutorial, we coded a reset button that opened a new instance of the GUI and closed the old instance. In this tutorial, we are going to create a reset button by setting all the pertinent values within the GUI to their default values. In addition, we will clear all axes of their data and labels. For this tutorial, we will be working with the GUI shown below.

Finished GUI

The Example Files and Code

First, download the GUI skeleton here. Unzip the files and place them wherever you please.
Now, type guide at the command prompt.
Choose to open the sample GUI by clicking on “Open Existing GUI”. Click on “Browse” to locate where you saved the GUI files.
Here is what the GUI should look like when you open it:
Click on the icon on the GUI figure to bring up the accompanying .m file.
Find the reset_Callback and add the following code
```
reset_gui; %calls the reset_gui m file
```

Create an m-file named reset_gui. Make sure it’s located in the same directory as the other two files. This m-file will store all the initialization values for the reset button. When you press the reset button, it will set all the parameters to the values specified in this m-file. Paste the following code into the m-file:

%the following code initializes the relevant parameters to their default values
%this is essentially what a reset button does!
set(handles.input1_editText,'String','0');  %sets input1 to 0
set(handles.input2_editText,'String','0');  %sets input2 to 0
set(handles.answer_staticText,'String','0'); %sets answer to 0
cla(handles.axes1,'reset'); %clears the axes

Note: Instead of creating a separate m-file, we could have just added the previous code directly into the reset_Callback function. Since this GUI is simple, it would have been easier to do it that way. But when you have a larger GUI with many more parameters, it is easier to designate an m-file to initialize your parameters.
Now run the GUI and test it out! Input some numbers and add them. Plot the data. Once you are done, try the reset button.

Advantages and Disadvantages

The main advantage of coding the reset button this way is that there is no “flicker” when you activate the reset button. On the flip side, one of the main disadvantages is that you have to hardcode the initialization code for each parameter. If you decide to make modifications to your GUI, you would have to manually change the initialization code to keep up with all the relevant parameters. With the other reset button method, you never have to worry about this.

Conclusion

In this tutorial, you learned a different way to implement a reset button. I prefer using this method to code my reset button because I really don’t like the flickering from the previous method. It may take a little extra diligence, but the end product is superior in my opinion.

Download the Source Files

Click here to download the source files.

This is the end of the tutorial.

19 Responses to “MATLAB GUI - Creating a Reset Button Part II”

on 14 Jul 2008 at 4:15 am 1RaHuLYD

I prefer creating a function such as “GUI_init_state()” that will be executed when the GUI loads and initialize the values of various parameters to wht i want. This is especially useful if u want to have various states of the GUI like: 1) startup, 2) reset, 3) exit, 4) others

on 14 Jul 2008 at 12:11 pm 2dp

Great tutorial, as always!

I’d like to add that another benefit of this method is that it’s easy to add another button to save the current values as a default, then reset to that default. For example:

On initialization, you can make a “default” substructure as part of handles:

handles.default.input1str='0';

…and so forth for all the defaults you need to set

Then your reset_gui function will be:

set(handles.input1_editText,'String',handles.default.input1str);
...

Then you can add a button to set current values as default, using a callback like:

handles.default.input1_editText=get(handles.input1_editText,'String');

Plus, if you set up the defaults as a structure, you can use dynamic field names to set/reset the parameters in order to allow easy growth of your GUI:

defnames=(fieldnames(handles.default));
%initialize, assuming they are all the same data type:
for vctr=1:length(defnames)
  handles.default.(defnames{vctr})='0';
end
%save current as defaults, assuming they are all the same data type:
for vctr=1:length(defnames)
  handles.default.(defnames{vctr})=get(handles.(defnames{vctr}),'string');
end
%reset:
for vctr=1:length(defnames)
  set(handles.(defnames{vctr}),'string',handles.default.(defnames{vctr});
end

on 14 Jul 2008 at 12:40 pm 3Quan Quach

Hey dp,

Thanks for the added tip. This can save a lot of time when you might need to change your default settings to something else. Great use of structures to make things easier to program.

Quan
on 14 Jul 2008 at 12:42 pm 4Quan Quach

Hi Rahul,

Somehow you comment got sent to the spam,

Your method is a good one too! I think that’s how Daniel implements his reset.

Quan
on 24 Sep 2008 at 5:27 am 5DEVANAND

What a nice work this site is.I am an M-beginner.
I have a doubt.

I have a GUIDE application. Now I wanted to uncheck and check the checkboxes by clicking a pushbutton. How can it be done , plz help me.

THANKS IN ADVANCE

on 12 Nov 2008 at 2:45 am 6Michael N.

Hi guys! I’m new to this site. Chanced upon it while I was looking up online tutorials on how to work the GUIDE on MATLAB and I have to say this site rocks! Great effort!

I have a problem now which I am trying to tackle, it is similar to the reset function and I think the reset function should work in the same way for me. The problem is that I am unable to make dp’s code to work. He says to call a default substructure on initialization but I don’t know where that is.

Also, another issue with his code is that it does not account for cases where the handle.(defnames(vctr)) does not have a ‘String’. But great idea nevertheless. Either that or maybe I’m just not doing it right. More likely the latter.

So what I’ve tried is to place the code

handles.default=handles;

at the addinggui_OpeningFcn but it did not enter my edit text box callback named Operator_Callback. This didn’t work as when I used the debug function, the handles structure did not contain default.

Essentially I want to make a code such that if someone enters an incoherent value into a edit text box, the value will reset to the last accetable value entered rather than a default value. Works similarly to how you can use the Esc key in Excel to undo whatever you have entered into a cell as long as you are still in the edit mode.

Also could you explain why the handles.default does not get passed into the function Operator_Callback? I thought the function was meant to pass in the whole structure.

PS. sorry for the messy coding, was just doing wierd things with this code. LOL

Thanks in advance for the help.

Mike

function varargout = addinggui(varargin)
 
gui_Singleton = 1;
gui_State = struct('gui_Name',       mfilename, ...
                   'gui_Singleton',  gui_Singleton, ...
                   'gui_OpeningFcn', @addinggui_OpeningFcn, ...
                   'gui_OutputFcn',  @addinggui_OutputFcn, ...
                   'gui_LayoutFcn',  [] , ...
                   'gui_Callback',   []);
if nargin &amp;&amp; ischar(varargin{1})
    gui_State.gui_Callback = str2func(varargin{1});
end
 
if nargout
    [varargout{1:nargout}] = gui_mainfcn(gui_State, varargin{:});
else
    gui_mainfcn(gui_State, varargin{:});
end
 
 
 
function addinggui_OpeningFcn(hObject, eventdata, handles, varargin)
handles.output = hObject;
guidata(hObject, handles);
 
handles.default=handles;
 
function varargout = addinggui_OutputFcn(hObject, eventdata, handles) 
 
varargout{1} = handles.output;
 
 
function edit1_Callback(hObject, eventdata, handles)
 
 
input = str2num(get(hObject,'String'));
 
 
if (isempty(input))
     set(hObject,'String','0')
end
guidata(hObject, handles);
 
function edit1_CreateFcn(hObject, eventdata, handles)
 
if ispc &amp;&amp; isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end
 
 
 
function edit2_Callback(hObject, eventdata, handles)
 
 
input = str2num(get(hObject,'String'));
 
 
if (isempty(input))
     set(hObject,'String','0')
end
guidata(hObject, handles);
 
 
function edit2_CreateFcn(hObject, eventdata, handles)
 
 
if ispc &amp;&amp; isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end
 
 
 
function pushbutton1_Callback(hObject, eventdata, handles)
 
a = get(handles.edit1,'String');
b = get(handles.edit2,'String');
operate=get(handles.Operator,'String');
 
 
switch operate
    case {'+'}
        total = str2num(a) + str2num(b);
    case {'-'}
        total = str2num(a) - str2num(b);
    case {'/'}
        total = str2num(a) / str2num(b);
    case {'*'}
        total = str2num(a) * str2num(b);
end
 
 
c = num2str(total);
 
set(handles.answer_staticText,'String',c);
guidata(hObject, handles);
 
 
 
 
 
 
function Operator_Callback(hObject, eventdata, handles)
 
 
 
 
a=get(handles.text2,'String');
 
% g=get(handles.default.Operator,'String')
b=get(hObject,'String');
c=size(b);
 
 
if (isempty(str2num(b)))&amp;&amp;c(2)==1
 
set(handles.Operator,'String',b);
set(handles.text2,'String',b);
 
else
 
    set(handles.Operator,'String',a);
end
 
guidata(hObject, handles);
 
function Operator_CreateFcn(hObject, eventdata, handles)
 
if ispc &amp;&amp; isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end

on 12 Nov 2008 at 3:34 am 7Quan Quach

Wow, what a huge comment. Gimme some time to come up with a suitable answer!

on 12 Nov 2008 at 11:33 am 8Quan Quach

Hi Mike,

handles.default=handles;

The code above is not going to work but its difficult for me to explain why that is. Let’s just take it at face value.

In regards to DP’s method:

What DP is doing is creating a structure WITHIN the handles structures that stores all the initialization values. For instance, in your code it looks like you have variables a,b, and c and you would like to reset those:

Your initialization structure would be something like:

%these are the values your GUI will reset to when you press reset
%notice that default is a structure stored within the handles structure
handles.default.a = '0'; 
handles.default.b = '0';
handles.default.c = '0';
 
%make sure this line is the last line of the opening function
%so that the handles structure will update!
guidata(hObject, handles);

If you want to default the edit text field to the last known good value, you can do something similar, such as:

%initialize this structure
handles.lastKnownGoodValue.a = '0'; 
handles.lastKnownGoodValue.b = '0';
 
%make sure this line is the last line of the opening function
%so that the handles structure will update!
guidata(hObject, handles);

Now, in your callback for edit1 you could do:

function edit1_Callback(hObject, eventdata, handles)
 
input = str2num(get(hObject,'String'));
 
if (isempty(input))
     set(hObject,'String',handles.lastKnownGoodValue.a)
     return  %exits the function
end
 
%if the most recent entry is good, we wan to replace the last known good value
handles.lastKnownGoodValue = (get(hObject,'String'));
guidata(hObject, handles);

Good luck with your GUI!

Quan

on 12 Nov 2008 at 8:40 pm 9Michael N.

Woah thanks Quan for the quick reply! It works and I think part of the problem was me not using
```
guidata(hObject, handles);
```
Thanks for clarifying my mistake and saving me alot of trouble Quan!

On a side note, I was toying with the idea of creating a GUI with a list box on the left side. If you were to click on any of the objects on the list, it would fill up the empty space on the right side of the GUI with different options depending on the list box object that was selected. Was wondering how to go about doing that. I came up with a few ideas, one would be similar to the reset method number 1 where you just opened a new GUI which had a similar layout.

I suspect that if you want to be able to have that kind of interaction on the GUI itself without using the reset trick, you would have to use ActiveX control. Could you recommend anything to read so I can learn more about it?

P.S. I’ll try to be less liberal with my commenting.

Thanks!
on 08 Jan 2009 at 1:54 pm 10Asuka

Thank you in advance ^______________^

on 10 Jan 2009 at 8:59 pm 11Hana

Hi, I wanna ask, why my GUI only reset for the axes only? I’ve try several times, but it’s still reset the graph, but not my edit1 and edit2 boxes. Here is my codes:

function edit1_Callback(hObject, eventdata, handles)
 
NewStrVal=get(hObject,'String');
handles.edit1=NewStrVal;
guidata(hObject,handles);
 
function edit1_CreateFcn(hObject, eventdata, handles)
if ispc &amp;&amp; isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end
 
function edit2_Callback(hObject, eventdata, handles)
 
NewStrVal=get(hObject,'String');
handles.edit2=NewStrVal;
guidata(hObject,handles);
 
function edit2_CreateFcn(hObject, eventdata, handles)
if ispc &amp;&amp; isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end
 
% --- Executes on button press in pushbutton1.
function pushbutton1_Callback(hObject, eventdata, handles)
 
axes(handles.axes1)
 
%user input a and b
 
a = handles.edit1; % now a string
b= handles.edit2; % now a string
 
v=['y^2=x^3+' a '*x+' b];
 
plot(v,[-40,40],[-40,40]);
 
 
% --- Executes on button press in clear_pushbutton2.
function clear_pushbutton2_Callback(hObject, eventdata, handles)
 
cla(handles.axes1,'reset');
 
set(handles.edit1,'String','');
set(handles.edit2,'String','');

on 02 Feb 2009 at 11:14 am 12tyui

How can i reset values that are not on the gui itself?

for example
im going to start a program and i want to graph my outputs which will be more than 100. how do i implement the code so that it will take the outputs without having me to put them in in the box value like you have it. Meaning that as soon as i press ’stop’, i want a graph to appear from the data obtained.THen i want to press the ’start’ button to start the program again but it to reset the values and clear the graph at the same time.
on 13 Feb 2009 at 2:57 am 13Monica

Hi everybody!
I have a problem in sharing data between sub guis and main gui.
I have a main Gui with a Menú Editor.
Each menú is aimed to insert input parameters (e.g.: dipole position in x,y,z).
So, when I click on the menú “dipole position”, the main Gui calls a subgui that reads these values and save them.
The problem is that I’m not able to access these values from the main Gui since in the main there are not the objects xd, yd, zd - (I want just to use them in a function for computing the field) - so the commands ” set” and ” get” do not work. I think I would have to use the varargout function to pass the read input parameters as output from the sub gui to the main gui. But I don not know how it works…I hope somebody can help me!!!

I did in this way, more or less:

Subgui:

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

user_entry_xd=str2double(get(hObject, ‘String’))*1e-2;
if isnan(user_entry_xd)
errordlg(’You must enter a numeric value’, ‘Bad Input’, ‘ modal’);
end
handles.subgui_xd_dipole_edit=user_entry_xd;
%handles.xd=user_entry_xd;
guidata(hObject,handles);

and son on for y and z.

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

mainGUIhandle = MCF_Simulator;
mainGUIdata = guidata(mainGUIhandle);

(The following commands of course can not work since in the main gui I don’t have the objects xd,yd,zd):

set(num2str(mainGUIdata.xd,’String’), get(num2str (handles.subgui_xd_dipole_edit, ‘String’)));
set(num2str(mainGUIdata.yd,’String’), get(num2str(handles.subgui_yd_dipole_edit, ‘String’)));
set(num2str(mainGUIdata.zd,’String’), get(num2str(handles.subgui_zd_dipole_edit, ‘String’)));

close(MCF_SubGui_dipole_pos);

Then in the MainGui I was trying to do something like:

xd = str2double(get(handles.xd));
yd = str2double(get(handles.yd));
zd = str2double(get(handles.zd));

But it does not recognize the handles of course!

I hope it is enough clear…It’s the first time I’m programming a GUI… :s
on 05 Apr 2009 at 9:57 am 14bob

is that possible to clear the whole workspace with this reset button?

sometimes, i find out that,it’s hard to clear the variables in workspace within GUI

if our GUI has different callback functions

we send the variables of callback A to workspace

and want to clear the workspace with callback B,with clear all; or clear var;

i tried,but didn’t work, it’s weird
on 15 Apr 2009 at 7:57 pm 15Christina

I added a reset pushbuttom to my GUI and I can reset my edit text boxes but I also have some popupmenus that I want to go back to the first case (first option) after the reset pushbutton is selected. What is the code for this?

Thanks for the help. This had been a great website!
on 16 Apr 2009 at 6:47 am 16Zane Montgomery

Christina, this is all you should need.

set(handles.popupmenu1,’Value’,1);
on 16 Apr 2009 at 7:08 am 17Christina

Zane, Thanks for the reply to both my questions!!!! Both worked perfectly. This is a great website!!!
Christina
on 29 May 2009 at 6:17 pm 18poo

hey i want to implement an undo function .which will return to the previous state
i m loading a picture on the axis,then selecting points on it,which will give me the outline of the figure from the point selected,now i want to implement an undo button which will give me only the figure without the outline and i should be able to select the points again

please help

on 20 Aug 2009 at 11:19 am 19confused

I am creating a GUI, I have 4 ‘EDIT TEXT’ boxes named POS1_1, POS1_2, POS2_1, and POS2_2. Is there a way for me to do this code:

set(handles.POS1_1, 'BackgroundColor', 'green');
set(handles.POS1_2, 'BackgroundColor', 'green');
set(handles.POS2_1, 'BackgroundColor', 'green');
set(handles.POS2_2, 'BackgroundColor', 'green');

as something like:

for n= 1:2
    for m = 1:2
        set(handles.POSn_m, 'BackgroundColor', 'green');
    end
end

Include MATLAB code in your comment by doing the following:

<pre lang="MATLAB">

%insert code here

</pre>

blinkdagger