Setting the Matlab desktop layout programmatically

The Matlab desktop enable users to switch between different presentation layouts of the desktop panels (Command Window, Workspace etc.). This has been supported as far back as Matlab 6 (R12), with newer Matlab releases adding improved functionality such as the ability to save user-defined layouts, as Kristin explained in the official Matlab desktop blog.
The only supported way to save and switch layouts is to use the desktop’s main menu. Since Kristin has posted her write-up, a few people have posted unanswered follow-up comments requesting to know how to programmatically save and switch layouts. I will now show how this can be done.
First, we need to get the Java handle of the Matlab desktop. We can then investigate this handle using the built-in methodsview function or my UIInspect utility on the File Exchange. We quickly see the relevant layout-related functions, which we can put to good use:

% Get the desktop's Java handle (Matlab 7 only)
desktop = com.mathworks.mde.desk.MLDesktop.getInstance;
% Inspect the available desktop functions
methodsview(desktop);
uiinspect(desktop);
% Save the current layout
desktop.saveLayout('Yair');
% Switch between different layouts
desktop.restoreLayout('Yair');
desktop.restoreLayout('Default');
desktop.restoreLayout('History and Command Window');
% Get the desktop's Java handle (Matlab 7 only) desktop = com.mathworks.mde.desk.MLDesktop.getInstance; % Inspect the available desktop functions methodsview(desktop); uiinspect(desktop); % Save the current layout desktop.saveLayout('Yair'); % Switch between different layouts desktop.restoreLayout('Yair'); desktop.restoreLayout('Default'); desktop.restoreLayout('History and Command Window');

Note that trying to restore an invalid layout name simply does nothing (does not throw an error).
Also note that this relies heavily on unsupported and undocumented internal implementation, which may change without prior notice between Matlab releases. The code snippet above works on several Matlab 7 releases. But for Matlab 6.0 (R12), for example, it needs to be modified:

% Get the desktop's Java handle (Matlab 6 only)
desktop = com.mathworks.ide.desktop.MLDesktop.getMLDesktop;
% Inspect the available desktop functions
% Note: in Matlab 6, methodsview() did not accept object handles
methodsview('com.mathworks.ide.desktop.MLDesktop');
%uiinspect(desktop);  % UIINSPECT does not work on Matlab 6
% Save the current layout
% saving the desktop is not possible in Matlab 6
% Switch between different layouts
desktop.set5PanelLayout;
desktop.setTallLayout;
desktop.setShortLayout;
desktop.setDefaultDesktop;
desktop.setMolerMode;        % ='Command window only'
% Get the desktop's Java handle (Matlab 6 only) desktop = com.mathworks.ide.desktop.MLDesktop.getMLDesktop; % Inspect the available desktop functions % Note: in Matlab 6, methodsview() did not accept object handles methodsview('com.mathworks.ide.desktop.MLDesktop'); %uiinspect(desktop); % UIINSPECT does not work on Matlab 6 % Save the current layout % saving the desktop is not possible in Matlab 6 % Switch between different layouts desktop.set5PanelLayout; desktop.setTallLayout; desktop.setShortLayout; desktop.setDefaultDesktop; desktop.setMolerMode; % ='Command window only'

Note that Matlab 6 did not have a generic restoreLayout() function, instead using a few pre-defined setXXX(). Also note that Matlab 6 did not have the saveLayout() function (it did have saveDesktop(string,string) and restoreDesktop(string,string), which I leave as an excercise to readers).
This has been the first example of many useful things that can be done with the Matlab desktop handle. In the future I will describe other aspects. Perhaps the main lesson to be learned from this post is that essentially anything that can be done via the menu can also be done programmatically.

close(matlab.desktop.editor.findOpenDocument('myMatlabFunction.m')) % close editor file close(findall(0, 'type','figure', 'name','My figure')) % close a specific figure window jDesktop = com.mathworks.mde.desk.MLDesktop.getInstance; jDesktop.closeGroup('Figures'); % close the Figures container

6 Responses

Troykapoika March 16, 2011 at 01:06 Reply

I would like to know if there is any way to organize (remove) layouts programmatically? I have played around with uiinspect looking for the calls to organize and remove layouts, but I haven’t been too successful. Also, do you know if there is anyway to share layouts between computers and load them into MATLAB without having to restart MATLAB?

Thanks!

Troy
Sky October 24, 2013 at 02:23 Reply

This post inspired me to make a small utility (now on the File Exchange) that I personally use very often and find quite useful. Hopefully others will too. Thank you for the post. I’d love to get feedback on the file if you have any for me.

Yair Altman October 24, 2013 at 02:35 Reply

nice 🙂

Anderson April 29, 2014 at 12:40 Reply

Hi,

Is there a command similar to desktop.closeCommandWindow, so that I can close/open editor window and figures window?

Thank you

Yair Altman April 29, 2014 at 12:50 Reply

@Anderson:

Dominik March 24, 2016 at 11:47 Reply
Dear Yair,

thank you for all those helpful matlab secrets!
I was wondering how to arrange figures in my tiled custom desktop group.
The group I create like that:
desktop.setDocumentArrangement(groupname, 2, java.awt.Dimension(nXPanes, nYPanes));
desktop.setDocumentArrangement(groupname, 2, java.awt.Dimension(nXPanes, nYPanes));
And the figures I associate via:
set(get(handle(o.figure), 'javaframe'), 'GroupName', groupname);
set(get(handle(o.figure), 'javaframe'), 'GroupName', groupname);
Now I would ideally like to control in which pane the figures are created and, possibly be able to create tabbed figures within one pane.
I would be delighted about any hint.

Thank you!

Rolf (18 days 2 hours ago): Disclosure: This comes from the developer/vendor of the Code Checker for MATLAB. Have a look at the Code Checker for MATLAB by MonkeyProof Solutions which has many such (configurable)...
Yair Altman (25 days 19 hours ago): In theory you could use the data: URI scheme (e.g. .load('data:text/html,<html ><body>Hello world</body></html>')), but for some reason it doesn’t work well in...
Sebastian (26 days 1 hour ago): Thanks for your update to the now unsupported `HTMLBrowserPanel`. I tried to replace it with the `LightweightHelpPanel` but the application I am working on is showing generated...
Leuze (48 days 2 hours ago): Hello, I would like to add a new object into SLDD and display columns according to my object properties <>
Eric Delgado (77 days 4 hours ago): Hey Yair, I think your site is the right place to share that I wrote ccTools, a lib that allows a lot of customizations of Matlab built-in web components (such as uifigure,...
Eric Delgado (77 days 5 hours ago): Hey guys, first of all, thanks to @Yair, your site saved me a lot of times! 🙂 That’s why I am sharing that I wrote m2mlapp (*.m => *.mlapp) file conversion, that...
François (94 days 2 hours ago): more than 10 years later it helps me after struggling few hours, so thanks you very much !
Yair Altman (95 days 0 hours ago): I am not familiar with a universal catch-all tab-completion mechanism for all functions, and it also doesn’t make much sense to me, because different functions use...
Arye (95 days 18 hours ago): hi, is there a universal functionSignature.json file that will allow my to get the function hints when opening brackets of my funcs? something that automaticly recognize my function...
Sunham (98 days 13 hours ago): This is an old article, but the issue persists even in 2023. 2023a: z = mat2cell(1:1e6,1,repmat(1,1,1e 6)); f = @() cellfun(‘isempty’, z); g = @() cellfun(@isempty,z);...
Yair Altman (108 days 3 hours ago): Robot only runs when you tell it to run a command such as keyPress. If you don’t tell it to run a command, it uses no CPU, so there’s no need to remove the Robot...
Eric (108 days 14 hours ago): Hey @Kevin, can you share your code about create group of figures in the AppContainer? The container of multiples uifigures could be an amazing improvement over AppDesigner and its...
Elsa Smith (109 days 5 hours ago): I recently used java.awt.Robot to perform GUI testing on MATLAB and found it to be an extremely easy and useful way to control mouse movements.
Elsa Smith (109 days 6 hours ago): I’m suspecting that the slow performance of my GUI may be due to the use of java.awt.Robot. Is there a way to cancel/stop/remove the robot after it has been created, or is...
Michelle Kline (109 days 22 hours ago): *edit* tip about fopen(), not about fwrite(). ‘Wb’ vs. ‘wb’

Related posts:

6 Responses

Leave a Reply