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

Minimize/maximize figure window

Posted By Yair Altman On May 18, 2011 | 51 Comments

Over the past couple of years, I posted several articles [3] using the JavaFrame property of the figure handle, which enables access to the GUI’s underlying Java peer object. Today, I show how using JavaFrame we can solve a very frequent user request on the Matlab CSSM forum.

The problem

Matlab figures can be maximized, minimized and restored by interactively clicking the corresponding icon (or menu item) on the figure window’s frame (the title bar). However, we often need to create maximized main-application windows, and wish to save the users the need to manually maximize the window. Moreover, we may sometimes even wish to prevent users from resizing a maximized main window.

Unfortunately, Matlab does not contain any documented or supported way to programmatically maximize, minimize or restore a figure window.

This is very strange considering the fact that these are such elementary figure operations. Moreover, these operations are supported internally (and have been for many releases already), as shown below. It is therefore difficult for me to understand why they were not added to the documented Matlab HG wrapper functionality a long time ago. I fail to understand why obscure features such as docking were added to the wrapper, but standard minimization and maximization were not.

Maximization

Several solutions [4] have been presented to this problem over the years. Let us start with the pressing question of figure maximization:

Solutions that rely on documented Matlab features tend to compute the available screen size and resize the figure accordingly. The result is lacking in many respects: it does not account for the taskbar (neither in size nor in location, which is not necessarily at the bottom of the screen); it does not remove the window border as in regular maximized figures; and it often ignores extended desktops (i.e. an attached additional monitor).

The solutions that do work properly all rely on undocumented features: Some use platform-specific native Windows API in a mex-file (Jan Simon’s recent WindowAPI [5] submission really pushes the limit in this and other regards). Alternately, we can easily use the platform-independent JavaFrame:

>> jFrame = get(handle(gcf),'JavaFrame')
jFrame =
com.mathworks.hg.peer.FigurePeer@cdbd96
 
>> jFrame.setMaximized(true);   % to maximize the figure
>> jFrame.setMaximized(false);  % to un-maximize the figure

Minimization

To the best of my knowledge, there are no solutions for minimizing figure windows that use documented Matlab features. Again, this can be done using either native Windows API, or the platform-independent JavaFrame:

>> jFrame.setMinimized(true);   % to minimize the figure
>> jFrame.setMinimized(false);  % to un-minimize the figure

Usage notes

Maximized and Minimized are mutually-exclusive, meaning that no more than one of them can be 1 (or true) at any time. This is automatically handled – users only need to be aware that a situation in which a window is both maximized and minimized at the same time is impossible (duh!).

There are several equivalent manners of setting jFrame‘s Maximized and Minimized property values, and your choice may simply be a matter of aesthetics and personal taste:

% Three alternative possibilities of setting Maximized:
jFrame.setMaximized(true);
set(jFrame,'Maximized',true);   % note interchangeable 1< =>true, 0< =>false
jFrame.handle.Maximized = 1;

jFrame follows Java convention: the accessor method that retrieves boolean values is called is<Propname>() instead of get<Propname>. In our case: isMaximized() and isMinimized():

flag = jFrame.isMinimized;        % Note: isMinimized, not getMinimized
flag = get(jFrame,'Minimized');
flag = jFrame.handle.Minimized;

In some old Matlab releases, jFrame did not possess the Maximized and Minimized properties, and their associated accessor methods. In this case, use the internal FrameProxy which has always contained them:

>> jFrameProxy = jFrame.fFigureClient.getWindow() 
jFrameProxy =
com.mathworks.hg.peer.FigureFrameProxy$FigureFrame[fClientProxyFrame,227,25,568x502,invalid,layout=java.awt.BorderLayout,title=Figure 1,resizable,normal,defaultCloseOperation=DO_NOTHING_ON_CLOSE,...]
 
>> % Three alternative possibilities of setting Minimized:
>> jFrameProxy.setMinimized(true);
>> set(jFrameProxy,'Minimized',true);
>> jFrameProxy.handle.Minimized = true;

Using FrameProxy for figure minimization and maximization works correctly on both old and new Matlab releases; using jFrame is slightly simpler but only works on recent Matlab releases. Depending on your needs you may choose to use either of these. They are entirely equivalent.

When either the Maximized or Minimized properties are changed back to false, the window is restored to regular mode, which is the FrameProxy‘s RestoredLocation and RestoredSize.

Use of the JavaFrame property

Note that all this relies on the undocumented hidden figure property JavaFrame, which issues a standing warning (since Matlab release R2008a) of becoming obsolete in some future Matlab release (HG2?):

>> jFrame = get(gcf,'JavaFrame')
Warning: figure JavaFrame property will be obsoleted in a future release.
For more information see the JavaFrame resource on the MathWorks web site.
(Type "warning off MATLAB:HandleGraphics:ObsoletedProperty:JavaFrame" to suppress this warning.) 

jFrame =
com.mathworks.hg.peer.FigurePeer@1ffbad6

To remove the above warning I have used (note the handle wrapper, as suggested [6] by Donn Shull):

jFrame = get(handle(gcf),'JavaFrame')

If and when JavaFrame does become obsolete in some future Matlab version, be sure to look in this blog for workarounds.

You may also wish to inform MathWorks on the dedicated webpage that they have set up for specifically this reason (http://www.mathworks.com/javaframe [7]), how you are using JavaFrame and why it is important for you. This may help them to decide whether to keep JavaFrame or possibly add the functionality using other means.

Do you have a smart use for the figure’s minimization or maximization feature? or another use for JavaFrame? If so, please share your ideas in a comment [8] below.

Categories: Figure window, GUI, Hidden property, Java, Medium risk of breaking in future versions, Undocumented feature, Undocumented function


51 Comments (Open | Close)

51 Comments To "Minimize/maximize figure window"

#1 Comment By Aurélien On May 19, 2011 @ 7:42 am

Hi Yair,

To maximise figures I use the outerposition property :

 figure('units','normalized','outerposition',[0 0 1 1])

In the past I used this following Technical solution
[15]
The drawback is that you have to recompile pcodes for each new release

Aurélien

#2 Comment By Jan Simon On May 23, 2011 @ 5:23 am

Dear Aurelien,
The debugger, inmem and L=import reveal that the P-files shown on solution 1-3MY8PN call the same java methods as used by Yair here. Hiding the code in a P-file is not really helpful.
Kind regards, Jan

#3 Comment By Jan Simon On May 23, 2011 @ 5:14 am

Hi Yair,
The results of setting the visible area of a figure to full-screen have been strange from Matlab 5.3 to 2009a (I cannot test current versions):

set(gcf, 'Units', 'normalized', 'Position', [0, 0, 1, 1])
get(gcf, 'Position')   % >> 0 0 1.0 0.9154

The same problem appeared in WindowAPI, when the window is resized without setting the SWP_NOSENDCHANGING flag in the Windows-API function SetWindowPos.
If the figure height is increased over the screen height, Matlab performs a magic movement automatically also:

set(gcf, 'Units', 'pixels', 'Position', [1, 1, 1024, 768])  % correct
pause(1);
set(gcf, 'Units', 'pixels', 'Position', [1, 1, 1024, 820])  % bad

But setLocation and setSize of javaFrame.fFigureClient.getWindow() works as expected.
Now I found out how to limit the dialog size efficiently. I cannot implement this in Matlab’s ResizeFcn reliably. But this works:

jh = get(handle(gcf), 'JavaFrame');
jp = jh.fFigureClient.getWindow();
jp.setMinimumSize(java.awt.Dimension(200, 200));

Thanks, Yair, to help me to find this method!
Kind regards, Jan

#4 Comment By Yair Altman On June 3, 2011 @ 9:28 am

For anyone interested, Leah Kaffine has [16] a trick to maximize a figure window on a second connected monitor:

set(gcf, 'Units', 'normalized', 'Position', [0, 0, 1, 1])  % maximize on main monitor
set(gcf, 'Units', 'normalized', 'Position', [1, 0, 1, 1])  % maximize on secondary monitor

On the same page, Ismail Ilker Delice has [17] a nice comment about the possibility to “minimize” windows, using the following pure-Matlab code:

set(gcf, 'Units', 'normalized', 'Position', [0, 0, 1, 1]);          % Maximization as suggested above
set(gcf, 'Units', 'normalized', 'Position', [-1, -1, eps, eps]);    % Minimize
set(gcf, 'Units', 'normalized', 'Position', [0.1, 0.1, 0.5, 0.5]);  % Restore

Using [-1,-1,eps,eps] is a nice trick to hide the figure window. However, it simply moves the figure to an impossible screen location (thereby hiding it) – it does not really minimize the figure. You can see this by right-clicking the figure icon in the task-bar – there is no “restore” option, just “minimize” and “maximize”. Still, I like the fact that this trick relies on the undocumented fact that [-1,-1,eps,eps] are acceptable parameters.

#5 Comment By Nikolay On June 7, 2011 @ 12:20 am

Hi Yair.
There are two problems with the solution you’ve proposed. whn running the command
1) The following warning “Warning: figure JavaFrame property will be obsoleted in a future release” is presented. While this warning can be turned off, it is bad news to see that this functionality will not work in future releases.

2) Sometimes a following Java error occurs

” java.lang.NullPointerException
at com.mathworks.hg.peer.FigureFrameProxy.setMaximized(FigureFrameProxy.java:208)
at com.mathworks.hg.peer.FigureMediator.setMaximized(FigureMediator.java:388)
at com.mathworks.hg.peer.FigurePeer.doSetMaximized(FigurePeer.java:3256)
at com.mathworks.hg.peer.FigurePeer$26.run(FigurePeer.java:3245)
at com.mathworks.hg.util.HGPeerQueue$HGPeerRunnablesRunner.runit(HGPeerQueue.java:229)
at com.mathworks.hg.util.HGPeerQueue$HGPeerRunnablesRunner.runNotThese(HGPeerQueue.java:261)
at com.mathworks.hg.util.HGPeerQueue$HGPeerRunnablesRunner.run(HGPeerQueue.java:277)
at java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.awt.EventDispatchThread.run(Unknown Source) “

#6 Comment By Yair Altman On June 7, 2011 @ 1:47 am

@Nikolay – I believe the occasional Java errors may be due to one of two reasons:

1. The figure is not yet fully rendered and visible when you are calling the setMaximized function. Unfortunately, JavaFrame functionality is only accessible when the figure is visible and fully rendered. So, for example, if you place the call to setMaximized in your GUI’s *_OpeningFcn() function (when the figure is not yet visible), it will fail. Instead, place the call in your GUI’s *_OutputFcn() function.

2. Another possible reason is due to [18]. The easiest solution is to place a call to drawnow; pause(0.1); before you access the JavaFrame functionality (setMaximized or any other Java function).

#7 Comment By Nikolay On June 14, 2011 @ 1:23 am

Hi again.
Indeed, a few minutes after writing my comment I’ve tried pause(0.3) and it seems to eliminate the errors. I have also bypassed the warning with “warning(‘off’,’MATLAB:HandleGraphics:ObsoletedProperty:JavaFrame’);” nut both issues solution is far from good Matlabing :(… That’s why i haven’t posted this solution on Matlab Central yet 😉

#8 Comment By S On September 30, 2011 @ 8:43 am

Hi everybody,
I’m a newcomer here on this fantastic page.
Here are my solution:

%for gui with guide (OutputFcn)
a=get(0,'ScreenSize');
set(handles.figure1,'position',a);

Have a nice weekend
S

#9 Comment By Yair Altman On October 1, 2011 @ 9:18 am

@S – this is indeed the regular solution but it does not create true maximization of the window, like you would expect from any other regular application. Also, it does not provide a solution for minimization. For these reasons we need to use the mechanism that was posted in the article above.

#10 Comment By Tadeu On April 20, 2012 @ 2:41 pm

Excellent solution! After lots of exhaustive searches, I’ve finally found a solution different from

set(handles.figure1,'position',get(0,'ScreenSize'));

which simply resize the OUTER BORDER of the figure window accordingly to the size of the screen, and not truly maximize it (i.e., VISIBLE AREA resized to fit the entire screen).

Very good indeed!
Thanks a lot!

#11 Comment By Bob On April 27, 2012 @ 12:02 pm

Hey everybody,

First of all congratulation to this post, but it is not clear in my mind how is possible to switch the units from pixel to normalized. I have understood that is possible with

[javaHandlePanel matlabHandlePanel] = javacomponent(jPanel,[400 200 500 500],figureHandle);
set(matlabHandlePanel,'units','normalized');

but if in the panel there are other javacomponent such as jButton or jTextField how we can use javacomponent function? Can we use the “mhandle”? I mean

[javaHandleText matlabHandleText] = javacomponent(jTitle,[100 100 200 200],matlabHandlePanel);
set(matlabHandleText,'units','normalized');

I have tried this solution but it is not working :(

Thanks in advance to everyone

Bob

#12 Comment By Yair Altman On May 10, 2012 @ 2:32 pm

@Bob – you can indeed use a uipanel handle, rather than the figure handle, as the javacomponent parent. Read [19] about it.

#13 Pingback By Customizing menu items part 2 | Undocumented Matlab On May 2, 2012 @ 7:06 am

[…] Note that we have used the figure handle’s hidden JavaFrame property, accessed through the reference’s handle() wrapper, to prevent an annoying warning […]

#14 Comment By Troykapoika On August 14, 2012 @ 3:34 pm

Hello Everyone!

Has anyone tried to use this when doing X-Forwarding through a SSH session on Linux? No matter what I do with changing the maximized or minimized Java state, it doesn’t impact what is going on with the window. Is there any way around this?

Thanks!

Troy

#15 Comment By Brian On November 27, 2012 @ 4:13 pm

Very nice. Any suggestions on maximizing/minimizing the entire MATLAB base window? I tried

jframe = get(0,'JavaFrame');

but it gives the following error.

Error using hg.root/get
The name 'JavaFrame' is not an accessible property for an instance of class 'root'.

I’m in R2012b on Linux.

#16 Comment By Malcolm Lidierth On November 27, 2012 @ 5:53 pm

@Brian

com.mathworks.mde.desk.MLDesktop.getInstance().getMainFrame()

#17 Comment By Bibo On December 17, 2012 @ 2:05 pm

Hi Yair,

Thanks very much for the solution.

However, I don’t know why your solution is still not a “real” maximization for my GUI: the taskbar are still there.

I am using Windows7 and MatlabR2010b.

Thanks in advance for your help!

#18 Comment By Yair Altman On December 17, 2012 @ 4:38 pm

@Bibo, in Windows the taskbar remains visible when you maximize any window in any application.

#19 Pingback By Anonymous On January 15, 2013 @ 9:59 pm

[…] […]

#20 Pingback By ScreenCapture utility | Undocumented Matlab On January 28, 2013 @ 8:17 am

[…] the solution of the rbbox-anywhere feature relies on using a temporary transparent window that spans the entire desktop area, capturing user rbbox clicks anywhere within the desktop area. […]

#21 Comment By Igor On June 17, 2013 @ 11:58 pm

>> Do you have a smart use for the figure’s minimization or maximization feature? or another use for JavaFrame? If so, please share your ideas in a comment below.

I’ve used JavaFrame to toggle “always on top” property: [20]

.. and, most probably, it can be used to access most of features, provided by this submission: [5] too.

#22 Comment By AKazak On August 20, 2013 @ 9:20 pm

MATLAB R2013a for

FigurejFrame = get(handle(gcf),'JavaFrame');
com.mathworks.hg.peer.FigurePeer@cdbd96

returns

‘cdbd96’ is not a valid base class.

#23 Comment By Yair Altman On August 20, 2013 @ 11:47 pm

@Andrey – the second line is the result of running the first line. It is not a separate command by itself, and you cannot run it by itself. It is simply the reference handle for the figure’s Java frame object FigurejFrame:

>> FigurejFrame = get(handle(gcf),'JavaFrame')
FigurejFrame = 
com.mathworks.hg.peer.FigurePeer@cdbd96

#24 Comment By AKazak On August 21, 2013 @ 11:13 am

OK, now it works in sample code, but in my script it gives:

java.lang.NullPointerException
at com.mathworks.hg.peer.FigureFrameProxy.setMaximized(FigureFrameProxy.java:249)
at com.mathworks.hg.peer.FigureMediator.setMaximized(FigureMediator.java:392)
at com.mathworks.hg.peer.FigurePeer.doSetMaximized(FigurePeer.java:3365)
at com.mathworks.hg.peer.FigurePeer$26.run(FigurePeer.java:3354)
at com.mathworks.hg.util.HGPeerQueue$HGPeerRunnablesRunner.runit(HGPeerQueue.java:262)
at com.mathworks.hg.util.HGPeerQueue$HGPeerRunnablesRunner.runNotThese(HGPeerQueue.java:294)
at com.mathworks.hg.util.HGPeerQueue$HGPeerRunnablesRunner.run(HGPeerQueue.java:310)
at java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.awt.EventDispatchThread.run(Unknown Source)

#25 Comment By Yair Altman On August 21, 2013 @ 1:07 pm

perhaps the figure window is not visible or fully rendered when you run setMaximized()

#26 Comment By AKazak On August 21, 2013 @ 7:22 pm

Is there a way to wait until figure window is fully rendered before calling setMaximized()?

#27 Comment By AKazak On August 21, 2013 @ 7:28 pm

This helped to achieve desired behavior.

drawnow;
pause(0.1);

Thank you!

#28 Pingback By Rich-contents log panel | Undocumented Matlab On September 24, 2013 @ 12:54 am

[…] Maximized figure window […]

#29 Comment By Ayantha On February 22, 2014 @ 11:36 pm

Hi Yair,
I put the following code in output function of my gui

jFrame = get(handle(gcf),'JavaFrame');
jFrame.setMaximized(true);   % to maximize the figure

But the figure is neither maximizing nor any error is displaying.

#30 Comment By Yair Altman On February 23, 2014 @ 3:20 pm

@Ayantha – I explained this in the Usage Notes section of the article – read carefully.

#31 Comment By Ayantha On March 6, 2014 @ 12:47 am

Thanks Yair,It worked. For some unknown reason, it didn’t work with an inbuilt example of Matlab. But it worked fine with my own code. Thanks again and keep your good work going.

#32 Comment By Terence On March 20, 2014 @ 4:57 pm

Any ideas on how to remove the Title Bar from the figure window? I’ve tried frame.setExtendedState(JFrame.MAXIMIZED_BOTH); frame.setUndecorated(true); but get the error “Undefined variable “JFrame” or function “JFrame.MAXIMIZED_BOTH”.”

#33 Comment By Yair Altman On March 20, 2014 @ 5:45 pm

@Terence – you cannot undecorate a Java Frame (figure window) using Java code after the JFrame is made visible, and you cannot access the JFrame in Matlab before it is made visible. In practice this means that you [probably] cannot do that with Java.

However, you may possibly be able to do it using Windows API if you’re running Windows. For this you can try using Jan Simon’s [5] utility.

#34 Comment By dubbel j On March 27, 2014 @ 7:29 am

Hi there,

I tried to loop minimizing multiple figures with this ‘JavaFrame’ property.
I works fine for minimizing the matlab desktop, the current figure and for a specific figure. But till now i cant loop these commands.

So is there a reason why this code does not work?

% minimize all other figures (if any)
a = get(0,'children');    % is this the proper way to get the figures ???
for n = 1: numel(a);
    fig = get(figure(a(n)),'JavaFrame');
    set(fig,'minimized',1);
end

The idea is that when i start a certain GUI, all other Matlab windows will be minimized.

Other options i have in mind:
1. resize all figures and put them to an edge of the screen
% but this is not what i want

2. trying to ‘auto-click’ the ‘show desktop’ button in windows 7
Then i just automatically minimize all, and then start my gui window. This would be my best case scenario.

btw, nice site, learned a lot about matlab here.

#35 Comment By Yair Altman On March 27, 2014 @ 7:59 am

@Dubbel – it should work, assuming all your figures are in fact visible. I would wrap the internals of the loop in a try-catch, so that if one figures fails to minimize, the others will still work. Something like this:

allFigs = findall(0,'type','figure');
for figIdx = 1 : numel(allFigs)
    try set(get(handle(allFigs(figIdx)),'JavaFrame'), 'minimized',true); catch, end
end

#36 Comment By dubbel j On March 27, 2014 @ 8:57 am

Thanks, yours works.

and figured out what my fault was:

 fig = get((a(n)),'JavaFrame');

instead off:

 fig = get(figure(a(n)),'JavaFrame');

so now both methods work :)

#37 Comment By Luis Vieira da Silva On August 27, 2014 @ 10:25 am

Hi,

On figure creation, I would like to maximize it (easily done with your method) and then prevents users to change its size. To do so I use documented Matlab function ( set(hfig,’Resize’,’off’) ). There seems to have a side-effect: figure is slightly maximized. That means inner borders of the window are at the limits of the screensize and the not outer borders.. Why ?

my code:

hfig=figure(...
  'Name','Topas' ,...
  'NumberTitle','off', ...
  'Resize','on',...
  'Units','pixels',...
  'Position',pos_fen,...
  'tag','main_fig',...
  'Menubar','none',...
  'Toolbar','none');
drawnow;pause(0.1);
jFrame = get(hfig,'JavaFrame');
jFrame.setMaximized(true); 
drawnow;pause(0.1);
set(hfig,'Resize','off')

Thanks in advance

#38 Comment By Yair Altman On August 27, 2014 @ 2:42 pm

@Luis – simply switch the order of the actions:

set(hfig,'Resize','off');
try
   jFrame.fHG1Client.setMaximized(true);  % HG1
catch
   jFrame.fHG2Client.setMaximized(true);  % HG2
end
drawnow; pause(0.1);

#39 Comment By Luis Vieira da Silva On August 28, 2014 @ 3:08 am

Thanks a lot, Yair, it works fine

#40 Comment By Luis Vieira da Silva On October 9, 2014 @ 7:05 am

Hi,

I have one last issue with the use of this programming technique. Here is my code:

hfig=figure(...
  'Name','Topas',...
  'NumberTitle','off', ...
  'Resize','off',...
  'Units','pixels',...
  'Position',[0 0 100 100],...
  'PaperPosition',[0 0 24 16],...
  'PaperSize',[24 16],...
  'tag','main_fig',...
  'Menubar','none',...   % défini par la suite
  'Toolbar','none');     % défini par la suite
 
drawnow;pause(0.1);
jFrame = get(handle(hfig),'JavaFrame');
try
    jFrame.fHG1Client.setMaximized(true);  % HG1
catch
    jFrame.fHG2Client.setMaximized(true);  % HG2
end
drawnow; pause(0.1)

It works fine until I double-click on the title bar (I am running Matlab R2014a on Windows 7 sp1). Then the window of my application shrinks to a small square (about 100×100 pixels) and there is no way I can maximize it again.

Thanks in advance for your help
Luis

#41 Comment By Yair Altman On October 9, 2014 @ 10:51 pm

@Luis – of course it does! what else did you expect? you created the figure with an initial size (Position) of 100×100 pixels, so when you de-maximize the figure it goes back to this size. Instead, create your initial figure with a larger size.

#42 Comment By Luis Vieira da Silva On October 9, 2014 @ 11:39 pm

Thank you for your help, Yair.

Indeed, that was obvious…

#43 Comment By ImageAnalyst On October 17, 2014 @ 9:34 am

Here’s my code:

% Enlarge figure to full screen.
jFrame = get(handle(gcf),'JavaFrame');
set(gcf,'Resize','off');
try
    jFrame.fHG1Client.setMaximized(true);  % HG1
catch
    jFrame.fHG2Client.setMaximized(true);  % HG2
end
drawnow; 
pause(0.1);

If I just let this run in R2014b (HG2) it throws an exception:

Error using test (line 60)
Java exception occurred:
java.lang.NullPointerException
	at com.mathworks.hg.peer.FigureFrameProxy.setMaximized(FigureFrameProxy.java:302)
	at com.mathworks.hg.peer.FigureMediator.setMaximized(FigureMediator.java:468)

and does not maximize the figure. HOWEVER, if I put a breakpoint anywhere in the try/catch, and it stops there, and I hit F5 to continue, it works just fine with no exception at all being thrown, just an orange warning:

Warning: figure JavaFrame property will be obsoleted in a future release. For more information see the JavaFrame resource on the MathWorks web site. 
> In test at 55

Why does it work only if there is a breakpoint stopped at and not when I just run it non-stop like I’d want?

#44 Comment By Yair Altman On October 18, 2014 @ 8:53 am

@IA – Probably because the figure window is not fully rendered when the jFrame code is reached. This is due to the fact that in R2014b, the figure function [21] until the figure is fully rendered.

I suggest moving the drawnow; pause(0.1); code to before the jFrame code, rather than after it – this will ensure that the figure is fully rendered at that time:

% Enlarge figure to full screen.
jFrame = get(handle(gcf),'JavaFrame');
set(gcf,'Resize','off');
drawnow; pause(0.1);
try
    jFrame.fHG1Client.setMaximized(true);  % HG1
catch
    jFrame.fHG2Client.setMaximized(true);  % HG2
end

#45 Comment By ImageAnalyst On October 29, 2014 @ 10:31 am

Yair, it works now. Just one little problem. It’s SO maximized that it covers up the Windows 7 task bar at the bottom of my screen. Is there any way to have it maximized but still have the taskbar show up? That’s the way maximizing normally works.

#46 Comment By Yair Altman On October 29, 2014 @ 10:51 am

@IA – I’m afraid that this is the behavior for figure windows that have Resize=’off’. If you set Resize=’on’ (the default value), then it will work as you expect vis-a-vis the taskbar. If you wish to get the Resize=’on’ behavior while still disabling resizing you can use the following code snippet:

jFrame = get(handle(gcf),'JavaFrame');  % Resize='on'
drawnow; pause(0.1);
try
    jClient = jFrame.fHG1Client;  % HG1
catch
    jClient = jFrame.fHG2Client;  % HG2
end
jClient.setMaximized(true);
jWindow = jClient.getWindow;
maxSize = jWindow.getSize;
jWindow.setMinimumSize(maxSize);
jWindow.setMaximumSize(maxSize);
jWindow.setLocation(java.awt.Point(0,0));

It’s not perfect, but close enough…

#47 Comment By Image Analyst On October 29, 2014 @ 1:49 pm

Thanks. I didn’t know what that resize stuff was – I just had it in there because other code above did, and I thought I needed it. I just removed that line and now everything works great. Thanks for figuring it out for me!

#48 Comment By Stijn Helsen On October 20, 2016 @ 9:47 am

I wanted to use the maximize function to get the size of the screen on which a figure is shown (using multiple screens). And “manually” (step by step) this works, but in a function, this doesn’t! In debugging mode, executing it, it works too.

jFrame = get(handle(figs(1)),'JavaFrame');
jFrame.setMaximized(true)
% nothing that I tried helps (drawnow, ...)
pos0 = get(figs(1),'Position');

When I first saw this, I thought: “simple: just add drawnow”, but that didn’t help.
Any idea?

#49 Comment By Yair Altman On October 20, 2016 @ 7:25 pm

@Stijn – try adding pause(0.5) after the drawnow. If it works then you can play with the pause duration to find the minimal duration value that works well on your specific system.

#50 Comment By Richard B Hodges On March 27, 2017 @ 4:34 am

In 2017a, jFrameProxy = jFrame.fFigureClient.getWindow() gives an error:

Undefined function or variable ‘fFigureClient’

Is there any replacement for functionality?

#51 Comment By Yair Altman On March 27, 2017 @ 11:40 am

@Richard – [22]


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

URL to article: https://undocumentedmatlab.com/blog/minimize-maximize-figure-window

URLs in this post:

[1] Image: http://undocumentedmatlab.com/feed/

[2] email feed: http://undocumentedmatlab.com/subscribe_email.html

[3] several articles: https://undocumentedmatlab.com/blog/tag/javaframe/

[4] Several solutions: http://www.mathworks.com/matlabcentral/fileexchange/?term=maximize+window

[5] WindowAPI: http://www.mathworks.com/matlabcentral/fileexchange/31437-windowapi

[6] suggested: https://undocumentedmatlab.com/blog/detecting-window-focus-events/#comment-2756

[7] http://www.mathworks.com/javaframe: http://www.mathworks.com/javaframe

[8] comment: https://undocumentedmatlab.com/blog/minimize-maximize-figure-window#respond

[9] Detecting window focus events : https://undocumentedmatlab.com/blog/detecting-window-focus-events

[10] Enable/disable entire figure window : https://undocumentedmatlab.com/blog/disable-entire-figure-window

[11] Transparent Matlab figure window : https://undocumentedmatlab.com/blog/transparent-matlab-figure-window

[12] Blurred Matlab figure window : https://undocumentedmatlab.com/blog/blurred-matlab-figure-window

[13] uiinspect : https://undocumentedmatlab.com/blog/uiinspect

[14] Figure window customizations : https://undocumentedmatlab.com/blog/figure-window-customizations

[15] : http://www.mathworks.com/support/solutions/en/data/1-3MY8PN/index.html?solution=1-3MY8PN

[16] : http://www.linkedin.com/groupAnswers?viewQuestionAndAnswers=&discussionID=56241295&gid=134533&commentID=40861819#commentID_40861819

[17] : http://www.linkedin.com/groupAnswers?viewQuestionAndAnswers=&discussionID=56241295&gid=134533&commentID=41046788#commentID_41046788

[18] : http://undocumentedmatlab.com/blog/matlab-and-the-event-dispatch-thread-edt/

[19] : http://undocumentedmatlab.com/blog/common-javacomponent-problems/

[20] : http://www.mathworks.com/matlabcentral/fileexchange/42252

[21] : http://www.mathworks.com/help/matlab/graphics_transition/why-do-figures-display-all-at-once.html

[22] : http://undocumentedmatlab.com/blog/hg2-update#observations

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