In a previous post, I explained that all Matlab GUI (except the axes plotting engine) is based on Java components, and showed how we can use this information to display HTML contents in Matlab ** uicontrol**s. In other posts, I have shown how a utility called

**can be used to access the underlying Java components to enable customizations that are unavailable in standard Matlab: setting the line location in an edit-box, customizing button appearance, setting uicontrol callbacks, or setting list-box mouse actions. I have also shown how**

*findjobj***can be used to display the component hierarchy of complex Matlab containers such as the figure window, GUIDE or the Editor.**

*findjobj*The time is therefore well overdue for a formal introduction of ** findjobj**, explaining its uses and internal mechanism. Of course, readers are welcome to continue using

**as a black-box utility, but I think important insight can be gained from understanding its inner details.**

*findjobj***‘s code is available for free download on the MathWorks File Exchange. It is one of my favorite submissions and is apparently well-liked by users, being highly reviewed and highly downloaded.**

*Findjobj*** Findjobj** has two main purposes:

- Find the underlying Java object reference of a given Matlab handle – Historically this was the original purpose, hence the utility’s name.
was meant to extend Matlab’s standard*Findjobj*function, which does not expose Java components.*findobj* - Display a container’s internal components hierarchy in a graphical user interface, to facilitate visualization of complex containers. This was later extended to also display and allow modification of the sub-components’ properties and callbacks.

Today I will focus on the first (programmatic) aspect; next week I will describe the second (GUI) aspect.

** Findjobj**‘s heart is finding a control’s underlying Java handle. Unfortunately, this is not exposed by Matlab except in very rare cases. As hard as I tried, I could not find a way to directly access the underlying Java-peer handle. I therefore resorted to getting the control’s enclosing Java frame (window) reference, and then working down its sub-components hierarchy until finding the Java object(s) which satisfy the position and/or class criteria. To get the enclosing Java frame (aka

*TopLevelAncestor*), I use the Matlab figure’s undocumented

**JavaFrame**property. Using this property issues a standard warning (since Matlab release R2008a) of becoming obsolete in some future Matlab release. Since it worked so far, I have turned off this warning in

**‘s code, but note that this code may well fail in some future Matlab version. If and when**

*findjobj***JavaFrame**does become obsolete, be sure to look in this blog for workaroundsâ€¦

Traversing the frame’s hierarchy presents several challenges: Main-menu items are accessed using different functions than other Swing components or sub-containers, and are not automatically accessible until first displayed. I have overcome this latter challenge by simulating a menu-open action in case menus should be searched (this is off by default since it takes several seconds and also changes the GUI focus). For “regular” sub-containers, sometimes we need to loop over *getComponent(…)* and in some other cases over *getChildAt(…)*.

Another challenge was presented by the fact that Java positions start at (0,0) in the __top__ left corner increasing rightward and __downward__, rather than starting at (1,1) in the bottom left and increasing upward as in Matlab. Moreover, Java positions are always pixel-based and relative to their parent container, which is different from Matlab (if the Matlab units is ‘pixels’ then the value is absolute; if ‘normalized’ then it returns a non-pixel value). To further complicate matters, some Matlab controls have a different size than their Java counterparts: some controls have a 5-pixel margins while others not, some controls are shifted by a pixel or two from their container’s border (for a total offset of up to 7 pixels), while some controls (such as popup-menus) have an entirely different reported size. In theory, we could use the Matlab component’s undocumented **PixelBounds** property (much faster than ** getpixelposition**), but unfortunately

**PixelBounds**turns out to be unreliable and returns erroneous values in many cases. Finally, different Java containers/components have different ways of returning their position: for some it is a

*getLocation()*method, for others it is

*getX()/getY()*and for others it is the

**X**and

**Y**properties (that sometimes have no corresponding

*getX()/getY()*accessor methods!).

Having finally overcome all these challenges (and quite a few smaller ones, documented within the source code), I have wrapped the algorithm in a function interface that tries to emulate ** findobj**‘s. Using

**can now be as easy as:**

*findjobj*% Modify the mouse cursor when over the button hButton = uicontrol('string','click me!'); jButton = findjobj(hButton); jButton.setCursor(java.awt.Cursor(java.awt.Cursor.HAND_CURSOR))

…or as complex as:

% Find all non-button controls with the specified label jControls = findjobj('property',{'text','click me!'}, 'not','class','button');

Space here is limited and ** findjobj** is over 2500 lines long, so I have obviously not covered everything. I encourage you to download the utility and explore the code, and I gladly welcome your feedback.

Related posts:

- FindJObj GUI – display container hierarchy The FindJObj utility can be used to present a GUI that displays a Matlab container's internal Java components, properties and callbacks....
- Setting status-bar components Matlab status-bars are Java containers in which we can add GUI controls such as progress-bars, not just simple text labels...
- Assessing Java object size in Matlab Java object sizes are not reported by Matlab, but we can still estimate them using two free external utilities. ...
- Date selection components The JIDE package, pre-bundled in Matlab, contains several GUI controls for selecting dates - this article explains how they can be used...
- Plot-type selection components Several built-in components enable programmatic plot-type selection in Matlab GUI - this article explains how...
- Color selection components Matlab has several internal color-selection components that can easily be integrated in Matlab GUI...

Dear Yair

Thank you very much for your great, great website. One really gets a feel for what is going on behind the scens in matlab.

I have a few question related to the findobj application:

You say that everything except the Java plotting engine is based on Java. I would like though to use the panelling from findobj in an application with for insatnce a matlab plot in one of the panels. Does your comment mean that I will be unsuccesful with that? If not, can you please give me a quick hint on how to get this?

Second, when you publish fĂndobj in “High risk of breaking…” what is the risk then? Does it include the panels feature that I am after or do you rather think of the more programmatic part of it?

Thank you very much in advance!

Peter

Thanks Peter.

Unfortunately, you cannot embed a Matlab plot axis in a Java container (only Java components in a Matlab container). However, to solve this problem I have created the

utility that behaves exactly like a Java JSplitPane, and enables interactively-resizable panels with Matlab plots:UISplitPaneTwo levels of UISplitPane, with customized dividers

As for your second question, I indicated “High risk of breaking in a future version” because FindJObj is highly dependent on internal Matlab implementation, which may break without warning between Matlab releases. For example, the very next release (R2010a) might remove the

JavaFrameproperty, on whichrelies. Of course, since I maintain this utility I will try to bypass the problem and upload a new version (andfindjobjhas an automated mechanism to detect and suggest this new version), but I cannot promise anything concrete. Some other undocumented features I believe to be less prone to breaking in future releases, and so they get a less severe warning. Note that I base the severity on gut instinct and calculated guesses – I have no official access to Matlab’s development roadmap.findjobjThank you very much Yair

I will have a look at the UIsplitpane utility. It seems more appropiate for my use.

Thanks again. It is a real cool site you have!

Peter

Yair

Your program is great, but I found some trouble using it. It seems like it only works with controls created by code. I tried to find underlying java object for controls created with GUIDE, and findjobj always returned empty handles arrays. it’s that posible? is there another way to find a JTextbox behind a uicontrol created with GUIDE?

Thanks,

Daniel

@Daniel – It works for me…

Perhaps you’re calling

in yourfindjobj_OpeningFcn()instead of in your_OutputFcn()or in callbacks? This would explain the problem, since the GUI has not yet rendered onscreen in_OpeningFcn()(the figure is still invisible), socannot find the Java handle.findjobjYair, you’re right. I was calling it in my OpenFcn() method. My purpose was set a InputVerifier to an edit control. Is there another callback in wich i can do that?

Thank you very much!

@Daniel – as I said, simply attach your

InputVerifierin the_OutputFcn()instead of in the_OpeningFcn(). Both of these functions are automatically created by GUIDE:_OpeningFcn()is invokedbeforethe figure is made visible and the Java peers are created;_OutputFcn()is invoked immediatelyafterit’s made visible, when the peers are in place.I would be happy if you added a comment with your

InputVerifiercode, for the benefit of other readers. If the code is long, email me (altmany at gmail) and I’ll add a separate post about it.Yair, i moved my code to the _OutputFcn, but findjobj still returns empty arrays. I couldn’t find out what is my error.

i’ve written a simple code which replaces uicontrols with javax.swing.JTextFields:

it works fine, but JTextFields not response Tab key strokes.

I could use both methods. I don’t know wich is better.

I deeply appreciate your help

Dear Yair

I am sorry for this kind of java newbie question, but I am back using the panes from the findobj. Now, instead of including a figure (as I asked about above) in one of the panes I would like to put a uitable or preferably your createtable from the FEX. I have tried many approaches, but none of them successful. I would be very happy if you have any directions on how to do it or have an example.

Thank you very much in advance!

Best regards, Peter

@Peter – look at the way I added the callbacks-table in the

andFindJObjutilities. The source code is available on the File Exchange.UIInspectYair

Thanks Yair! I will try to figure it out from there… As long as I know it should be possible, it puts a little more power behind the effort.

Peter

Pingback: Continuous slider callback | Undocumented Matlab

Pingback: Tabbed panes â€“ uitab and relatives | Undocumented Matlab

Pingback: GUI integrated HTML panel | Undocumented Matlab

Pingback: Customizing uicontrol border | Undocumented Matlab

Dear Yair , i am using findjobj to get the java handle of uitable to apply some java methods on it , but unfortunately using findjobj makes the uitabs and uitabgroups stop responding ! i can’t understand what’s going on but i hope that i am missing something so that i can fix and continue using it .

this is code sample to show what i am talking about , try and feedback me .

thanks a lot.

@Sherif – it works ok for me on WinXP R2010b. Perhaps you forgot a call to

before usingdrawnow, or perhaps you’re using an old version offindjobj.findjobji am using WinXP R2009a , tabs is working fine until i call findjobj :S , my findjobj version is updated , called drawnow before and after findjobj , but nothing changed .

i don’t know if the matlab version is the problem or there is something else .

i’ll try anyway .

Pingback: Tri-state checkbox | Undocumented Matlab

Pingback: HG2 update | Undocumented Matlab

Pingback: Variables Editor scrolling | Undocumented Matlab

Pingback: Rich-contents log panel | Undocumented Matlab

Pingback: Editbox data input validation | Undocumented Matlab

Pingback: Editable combo-box | Undocumented Matlab

Pingback: Using JIDE combo-boxes | Undocumented Matlab

Pingback: Listbox layout customization | Undocumented Matlab

Hi,

The function doesn’t work for matlab release 2013b.

Do you know how it will be possible to adjust it to work in this release?

Thanks!

Ruthy

@Ruthy – The

function works perfectly well on R2013b. It is your specific situation that perhaps doesn’t work, so I would suggest that you carefully check your code.findjobjPingback: Button customization | Undocumented Matlab

Hey Mr. Altman,

i have a question. I do create objects on the living program. That means for example i have uitabs and with every new uitab i add i add an editbox. Now on the first two editboxes i have “javahandle_withcallbacks.com.mathworks.hg.peer.utils.UIScrollPane” directly but on the third box i get a 1-by-4 handle. How can i ask which one is the one i need?

regards

@Christy – You can make them have distinct properties (Position, Text etc.) and then you could filter by that.

Pingback: checkClass | Undocumented Matlab

Pingback: Matlab GUI: Numeric input for serious work | Notes