Code covered by the BSD License  

Highlights from

5.0 | 4 ratings Rate this file 41 Downloads (last 30 days) File Size: 2.05 KB File ID: #42252
image thumbnail



Igor (view profile)


17 Jun 2013 (Updated )

WINONTOP allows to trigger figure's "Always On Top" feature

| Watch this File

File Information

WINONTOP allows to trigger figure's "Always On Top" state
* FigureHandle - Matlab's figure handle, scalar
* IsOnTop - logical scalar or empty array

* WinOnTop( hfigure, bool );
* WinOnTop( hfigure ); - equal to WinOnTop( hfigure,true);
* WinOnTop(); - equal to WinOnTop( gcf, true);
* WasOnTop = WinOnTop(...); - returns boolean value "if figure WAS on top"
* IsOnTop = WinOnTop(hfigure,[]) - gets "if figure is on top" property

* java enabled
* figure must be visible
* figure's "WindowStyle" should be "normal"

Written by Igor

16 June 2013 - Initial version
27 June 2013 - removed custom function call


Figure Window Always On Top, Set Figure Window To Be Always On Top., and Alwaysontop inspired this file.

Required Products MATLAB
MATLAB release MATLAB 8.1 (R2013a)
Other requirements java
Tags for This File   Please login to tag files.
Please login to add a comment or rating.
Comments and Ratings (14)
02 Dec 2014 Michael Hubatka


instead of

worked for me.

Comment only
24 Oct 2014 Alessandro Russo

I found the solution myself... just change HG1 to HG2 at line 68 and 71.


ps: HG stands for Handle Graphics and matlab switched from version 1 to version 2 in R2014b (see for instance

Comment only
24 Oct 2014 Alessandro Russo

Hi Igor,

in R2014b WinOnTop doesn't work anymore. I get the following error:

>> WinOnTop
Warning: figure JavaFrame property will be obsoleted in a future release. For more information see the JavaFrame resource on the MathWorks web site.
> In WinOnTop at 64
No appropriate method, property, or field fHG1Client for class com.mathworks.hg.peer.HG2FigurePeer.

Error in WinOnTop (line 68)
WasOnTop = jFrame.fHG1Client.getWindow.isAlwaysOnTop;

Can you fix it? :-)


Comment only
18 Sep 2014 Kanchibhotla Chandra Sekhar

I want to use this file while in opening function of GUI, But i am getting error that Figure is not visible. I can i make the GUI on top using opening function

29 Jul 2014 Jerry

Jerry (view profile)

03 Apr 2014 Bob

Bob (view profile)

I was trying to put an overlay window on top of X-Plane with no success - until I used your code! MANY THANKS.

31 Mar 2014 Ronobir Sarker

How can I find that file?

Comment only
27 Jun 2013 Igor

Igor (view profile)

Thanks, Christine !

Comment only
27 Jun 2013 Mark

Mark (view profile)

Hi Igor,
I'm having trouble getting the code to work. Should the file be placed in the active directory? I also get an undefined function error for 'ishandle_scalar'.


Comment only
27 Jun 2013 Christine

Hi Igor,
now it works fine. And I want to repeat the sentence I read so often here: Your program is exactly what I needed. Thanks a lot! :)

27 Jun 2013 Igor

Igor (view profile)

Hi Christine,
thanks for your notice.
It looks like I've made a couple of mistakes in the original code. I've just uploaded a new version. It would appear in a couple of days.

For now, you may just replace
"ishandle_scalar( FigureHandle )"
"isscalar( FigureHandle ) && ishandle( FigureHandle )".

Comment only
26 Jun 2013 Christine

Hello Igor,
I would very like to use your WinOnTop function but I always get an error message because of the ishandle_scalar function that does not seem to exist in my matlab path. Is it possible, that this function does not exist for my version (matlab 7.9 (R2009b)) and was only implemented in a later version? Can I get somehow around using it?


Comment only
20 Jun 2013 Igor

Igor (view profile)

This version is based on
get(handle(gcf),'JavaFrame') in contrast to
get(gcf,'JavaFrame') ... <blah-blah-blah>

Comment only
18 Jun 2013 Igor

Igor (view profile)

This version is based on get(gcf,'JavaFrame') which won’t return “Warning: figure JavaFrame property will be obsoleted in a future release.”, in contrast to get(gcf,'JavaFrame'), but it’s still possible that it would become obsolete in some future release. Though, most probably, there would be other workaround available.
… and

Comment only
27 Jun 2013

couple of critical fixes

Contact us