- Undocumented Matlab - https://undocumentedmatlab.com -

Customizing the standard figure toolbar, menubar

Posted By Yair Altman On January 9, 2013 | 12 Comments

A few days ago, a client asked me to integrate an MRU (most-recently-used) file list in a Matlab GUI window. The naive approach was to add a new “Recent files” main menu, but this would look bad. Today I explain how to integrate the MRU list into the toolbar’s standard “Open File” button, as well as into the standard “File” main menu.

Note: this relies on earlier articles about customizing the figure menubar [1], so if you are not comfortable with this topic you might benefit from reading these earlier articles.
Customizing the standard “File” main menu is easy. First, let’s find the “File” main menu’s handle, and add an MRU sub-menu directly to it:

hFileMenu = findall(gcf, 'tag', 'figMenuFile');
hMruMenu = uimenu('Label','Recent files', 'Parent',hFileMenu);

Our new MRU menu item is created at the end (in this case, at the bottom of the “File” main menu list). Let’s move it upward, between “New” and “Open…”, by reordering hFileMenu‘s Children menu items:

hAllMenuItems = allchild(hFileMenu);
set(hFileMenu, 'Children',fliplr(hAllMenuItems([2:end-1,1,end])));  % place in 2nd position, just above the "Open" item

Now let’s fix the “Open…” menu item’s callback to point to our custom openFile() function (unfortunately, the “Open…” menu item has no tag, so we must rely on its label to get its handle):

hOpenMenu = findall(hFileMenu, 'Label', '&Open...');
set(hOpenMenu, 'Callback',@openFile);

Finally, let’s add the MRU list as a sub-menu of the new hMruMenu. I assume that we have a getMRU() function in our code, which returns a cell-array of filenames:

% Add the list of recent files, one item at a time
filenames = getMRU();
for fileIdx = 1 : length(filenames)
    uimenu(hMruMenu, 'Label',filenames{fileIdx}, 'Callback',{@openFile,filenames{fileIdx}});
end

Modified standard figure menu-bar
Modified standard figure menu-bar


Clicking the main “Open…” menu item calls our openFile() function without the optional filename input argument, while selecting one of the MRU files will call the openFile() function with that specific filename as input. The openFile() function could be implemented something like this:

% Callback for the open-file functionality (toolbar and menubar)
function openFile(hObject,eventData,filename)
    % If no filename specified, ask for it from the user
    if nargin < 3
        filename = uigetfile({'*.csv','Data files (*.csv)'}, 'Open data file');
        if isempty(filename) || isequal(filename,0)
            return;
        end
    end
    % Open the selected file and read the data
    data = readDataFile(filename);
    % Update the display
    updateGUI(data)
end

We can take this idea even further by employing HTML formatting [2], as I have shown in my first article of the menubar mini-series [3]:

HTML-rendered menu items
HTML-rendered menu items

Customizing the standard toolbar's "Open File" button

Note: this relies on earlier articles about customizing the figure toolbar [4], so if you are not comfortable with this topic you might benefit from reading these earlier articles.
The basic idea here is to replace the standard toolbar's "Open File" pushbutton with a new uisplittool [5] button that will contain the MRU list in its picker-menu.
The first step is to get the handle of the toolbar's "Open File" button:

hOpen = findall(gcf, 'tooltipstring', 'Open File');
hOpen = findall(gcf, 'tag', 'Standard.FileOpen');  % Alternative

The second alternative is better for non-English Matlab installations where the tooltip text may be different, or in cases where we might have another GUI control with this specific tooltip. On the other hand, the 'Standard.FileOpen' tag may be different in different Matlab releases. So choose whichever option is best for your specific needs.
Assuming we have a valid (non-empty) hOpen handle, we get its properties data for later use:

open_data = get(hOpen);
hToolbar = open_data.Parent;

We have all the information we need, so we can now simply delete the existing toolbar open button, and create a new split-button with the properties data that we just got:

delete(hOpen);
hNewOpen = uisplittool('Parent',hToolbar, ...
                       'CData',open_data.CData, ...
                       'Tooltip',open_data.TooltipString, ...
                       'ClickedCallback',@openFile);

As with the menubar, the button is now created, but it appears on the toolbar’s right edge. Let’s move it to the far left. We could theoretically reorder hToolbar‘s Children as for the menubar above, but Matlab has an internal bug that causes some toolbar buttons to misbehave upon rearranging. Using Java solves this:

drawnow;  % this innocent drawnow is *very* important, otherwise Matlab might crash!
jToolbar = get(get(hToolbar,'JavaContainer'),'ComponentPeer');
jButtons = jToolbar.getComponents;
jToolbar.setComponentZOrder(jButtons(end),2);  % Move to the position between "New" and "Save"
jToolbar.revalidate;  % update the toolbar's appearance (drawnow will not do this)

Finally, let’s add the list of recent files to the new split-button’s picker menu:

% (Use the same list of filenames as for the menubar's MRU list)
jNewOpen = get(hNewOpen,'JavaContainer');
jNewOpenMenu = jNewOpen.getMenuComponent;
for fileIdx = 1 : length(filenames)
    jMenuItem = handle(jNewOpenMenu.add(filenames{fileIdx}),'CallbackProperties');
    set(jMenuItem,'ActionPerformedCallback',{@openFile,filenames{fileIdx}});
end

Modified standard figure toolbar
Modified standard figure toolbar

Clicking the main Open button calls our openFile() function without the optional filename input argument, while clicking the picker button (to the right of the main Open button) and selecting one of the files will call the openFile() function with that specific filename as input.
That’s it. Quite painless in fact.

Categories: Figure window, Java, Medium risk of breaking in future versions, Undocumented function


12 Comments (Open | Close)

12 Comments To "Customizing the standard figure toolbar, menubar"

#1 Comment By matteo On January 10, 2013 @ 08:26

Hi Yair

This is great stuff. I am sure when the time comes for me to dive into GUIs I will come back to this. I do have a couple of good ideas developed in Matlab waiting for a GUI.

#2 Comment By Dan On January 11, 2013 @ 10:16

Hi Yair,
I’ve been following your blog for a few years now, and first would like to say thank you. My comment isn’t exactly on the topic of this posting, but is closely related. I, like many others, have been frustrated by ML’s new desktop (as of R2012b). In particular, I’ve been irritated by the behavior of the figure toolbars when the figure group panel is docked (which has always been my preferred arrangement). For anybody who hasn’t tried it yet, all the figure toolbars, menubars, etc. get transferred up to a tab on the ribbon.
Especially frustrating is that I normally dock my figures on the right hand side of the desktop, which means that all the user interface components are on the far side of the screen from the figure, if the figure tab is even on top. Do you know of any way to return these interface components to the top of the figure group panel or the figures themselves? I think I could do an incredibly ugly and inefficient kludge by creating uibuttons in each figure when it’s created, but it seems to me there must be a better way.

Many thanks,
Dan

#3 Comment By Yair Altman On January 12, 2013 @ 17:23

@Dan – I do not know of a way to do this. I agree with you that the current situation is far from perfect. It might be less frustrating to get used to working in an undocked Figures group (i.e., all the figures are docked, but the Figures group itself is undocked). You then have the old menubar and toolbar available at the top of the Figures window, as you’re used to.

#4 Comment By Reza On January 12, 2013 @ 09:13

Hi
I GUI programmer in MATLAB and visit your site recently. this is really great and useful.
I have a guestion about java objects that added in GUI of MATLAB.
How can I change the dimention of these objects in MATLAB.
for example I create the JprogressBar in my GUI.
it has the specific dimention:
get(JprogressBar,’Width’) === 148
but when I try to change it width by
set(JprogressBar ,’Width’,300)
MATLAB send this message:
Changing the ‘Width’ property of javahandle_withcallbacks.javax.swing.JProgressBar is not allowed.
What should I do?

#5 Comment By Yair Altman On January 12, 2013 @ 09:26

@Reza – the javacomponent function that you use to display the JProgressBar returns a second output parameter that is the Matlab HG container. You can set this container’s Position property just like for any other Matlab HG control. alternately, you can set the Position directly in your call to javacomponent:

[hjProgressBar, hContainer] = javacomponent('javax.swing.JProgressBar', pixelPosition, gcf);
set(hContainer, 'Position', newPosition);

#6 Comment By Reza On January 13, 2013 @ 10:39

Hi
Thanks so much.
That is work. You are great….

#7 Comment By Dew On January 23, 2013 @ 04:06

When generating figure files using plot command in Matlab environment, the figure menu has items including Edit, View, Tools, etc… and toolbar contains the figure Edit tool Zoom etc.
But when the same script is executed after compiling it, it has only File in the menu item

Is there any way we can have standard Menu & tool bar in figure generated from compiled Matlab code
If not standard at least Zoom in, Zoom out, Edit, Copy, View Data (critical ones!)

Regards
Dew

#8 Comment By Yair Altman On January 23, 2013 @ 04:14

@Dew – assuming you’re using GUIDE, try to set a custom figure toolbar and simply drag your desired tool icons onto the toolbar, from the standard palette on the left of GUIDE’s toolbar designer window.

#9 Comment By Dew On January 23, 2013 @ 22:33

@ Yair, thanks for the reply
unfortunately my script is using plot on several occasions to create the .fig files
when running in Matlab environment it is fine but in stand alone environment I do not see any tool bar & in menu item only File is left

Regards
Dew

#10 Comment By Helly On July 9, 2015 @ 00:56

Hi Yair

Thanks for this wonderful post. I have created the recent files list in the menu and toolbar successfully. But there were problems:

Because I need to get the handles for different sessions, so I modified your code to pass the handles as follows

function handles = recent_file(handles)
delete(get(handles.hMruMenu, 'Children'));
filenames = getMRU();
for fileIdx = 1 : length(filenames)
    uimenu(handles.hMruMenu, 'Label',filenames{fileIdx}, 'Callback',{@tpa_open_TPA_re,handles,filenames{fileIdx}});
end

I call this function when I open a file or save a file. I listed all filenames I selected from the recent file menu or open file menu in a popupmenu. when I select any filename from the popupmenu, the list of the filenames should remain same, but in fact it is changed to less filenames. It seems to me that the handles wasn’t updated correctly.

Do you have any idea how to solve this problem?

#11 Comment By Yair Altman On July 9, 2015 @ 01:00

@Helly – your getMRU function probably returns less filenames than you expect. You should debug that function.

#12 Comment By Alireza Kharazmi On March 12, 2017 @ 13:41

Hi Yair,

I have created a GUI in Matlab for my data analysis. I am trying to modify the save button according to my need. I am using the code writing at the this page but with a bit of modification as written below:

hSave = findall(gcf, 'tooltipstring', 'Save Figure');
save_data = get(hSave);
hToolbar = save_data.Parent;
delete(hSave);
hNewSave = uisplittool('Parent',hToolbar, ...
                       'CData',save_data.CData, ...
                       'Tooltip',save_data.TooltipString); 
drawnow;  
jToolbar = get(get(hToolbar,'JavaContainer'),'ComponentPeer');
jButtons = jToolbar.getComponents;
jToolbar.setComponentZOrder(jButtons(end),3); 
jToolbar.revalidate;  

savelist = {'Save Reference Subtracted Spectra',...
    'Save Sum of Scaled Reference Spectra','Save Coeficients','Save All'};

jNewSave = get(hNewSave,'JavaContainer');
jNewSaveMenu = jNewSave.getMenuComponent;

for fileIdx = 1 : length(savelist)
    jMenuItem = handle(jNewSaveMenu.add(savelist{fileIdx}),'CallbackProperties');
    set(jMenuItem,'ActionPerformedCallback',...          @(jMenuItem,eventdata)photolysis_analyzer('mysave_ClickedCallback',hObject,eventdata,guidata(hObject)));
end

In the last line of the for loop I cannot use “set(jMenuItem,'ActionPerformedCallback' {@mysave_ClickedCallback,savelist{fileIdx}});” since it resets all my GUI handles. Now at this point, I want to recognise which savelist item is clicked in order to assign the appropriate action in my GUI.

I was wondering if you could help me with this problem.

Many thanks,
AKh


Article printed from Undocumented Matlab: https://undocumentedmatlab.com

URL to article: https://undocumentedmatlab.com/articles/customizing-standard-figure-toolbar-menubar

URLs in this post:

[1] customizing the figure menubar: http://undocumentedmatlab.com/blog/tag/menubar/

[2] HTML formatting: http://undocumentedmatlab.com/blog/html-support-in-matlab-uicomponents/

[3] first article of the menubar mini-series: http://undocumentedmatlab.com/blog/customizing-menu-items-part-1/

[4] customizing the figure toolbar: http://undocumentedmatlab.com/blog/tag/toolbar/

[5] uisplittool: http://undocumentedmatlab.com/blog/uisplittool-uitogglesplittool/

[6] Customizing figure toolbar background : https://undocumentedmatlab.com/articles/customizing-figure-toolbar-background

[7] Modifying default toolbar/menubar actions : https://undocumentedmatlab.com/articles/modifying-default-toolbar-menubar-actions

[8] Figure toolbar components : https://undocumentedmatlab.com/articles/figure-toolbar-components

[9] Figure toolbar customizations : https://undocumentedmatlab.com/articles/figure-toolbar-customizations

[10] Adding a search box to figure toolbar : https://undocumentedmatlab.com/articles/adding-a-search-box-to-figure-toolbar

[11] Reverting axes controls in figure toolbar : https://undocumentedmatlab.com/articles/reverting-axes-controls-in-figure-toolbar

Copyright © Yair Altman - Undocumented Matlab. All rights reserved.