File Exchange

image thumbnail

WinOnTop

version 1.4 (2.54 KB) by

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

16 Downloads

Updated

View License

WINONTOP allows to trigger figure's "Always On Top" state
INPUT ARGUMENTS:
* FigureHandle - Matlab's figure handle, scalar
* IsOnTop - logical scalar or empty array
USAGE:
* 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
LIMITATIONS:
* java enabled
* figure must be visible
* figure's "WindowStyle" should be "normal"
Written by Igor
i3v@mail.ru
2013.06.16 - Initial version
2013.06.27 - removed custom "ishandle_scalar" function call
2015.04.17 - adapted for changes in matlab graphics system (since R2014b)
2016.05.21 - another ishg2() checking mechanism

Comments and Ratings (26)

Mendi Barel

nice

This function is not working, I got this error on line 92 :

Struct contents reference from a non-struct array object.

Igor

Igor (view profile)

Jerry,
Thanks for the notice! I've just uploaded the fixed version.

Jerry

Jerry (view profile)

bug in line 61, should be if ~exist('isOnTop','var'); isOnTop=true; end
otherwise, the On Top Status could not be switched to 'Off'

arnold

arnold (view profile)

I use it every day!

PERFECT! Works from the box

Igor

Igor (view profile)

Sebastian,
thanks for the notice, I never ran into such versions myself. I've just uploaded a version, with a completely different approach to the handle graphics version check.

Sebastian

You should be careful with this test: "if str2double(v.Version) >= 8.4" Because some Matlab versions have two dots in its version, like R2010bSP2 uses "7.11.2".

:-)

Great!!!

Igor

Igor (view profile)

I've just updated the submission, so now it should work in either case: >=R2014b and <=R2014a , without any modification.
I'm sorry for not doing this for so long..

Michael Hubatka,
Alessandro Russo,
Many thanks for your suggestions!
It looks like Mathworks is going to add more modifications to their graphics system... So, it looks like it is hard to predict, which functionality would be removed in the following versions and which would not...

using
javax.swing.SwingUtilities.getWindowAncestor(jFrame.getAxisComponent);

instead of
jFrame.fHG2Client

worked for me.

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

Ale

ps: HG stands for Handle Graphics and matlab switched from version 1 to version 2 in R2014b (see for instance http://undocumentedmatlab.com/blog/customizing-axes-rulers).

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? :-)

Ciao
Ale

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

Jerry

Jerry (view profile)

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.

How can I find that file?

Igor

Igor (view profile)

Thanks, Christine !

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'.

Thanks,
Mark

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! :)

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 )"
with
"isscalar( FigureHandle ) && ishandle( FigureHandle )".

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?

Thanks,
Christine

Igor

Igor (view profile)

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

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.
See
http://undocumentedmatlab.com/blog/minimize-maximize-figure-window/
… and
https://www.mathworks.com/matlabcentral/newsreader/view_thread/246453#656957

Updates

1.4

fixed IsOnTop vs isOnTop bug

1.3

Trying to fix zip file getting damaged by Mathworks site.

1.3

fixed duplicate license.txt files

1.3

Another "is using Handle Graphics v2" check mechanism,

1.2

adapted for changes in matlab graphics system (since R2014b)

1.1

couple of critical fixes

MATLAB Release
MATLAB 8.1 (R2013a)

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video