Comments on: Context-Sensitive Help

By: Yair Altman

Yair Altman — Mon, 30 Nov 2009 16:52:05 +0000

I have expanded my answer to Dani’s question into a full article ( http://undocumentedmatlab.com/blog/customizing-help-popup-contents) and companion utility (popupPanel – http://www.mathworks.com/matlabcentral/fileexchange/25975).

Enjoy

By: Yair Altman

Yair Altman — Fri, 27 Nov 2009 12:47:41 +0000

Dani – yes: you can popup this HelpPopup window using the following:

jDesktop = com.mathworks.mde.desk.MLDesktop.getInstance;
jTextArea = jDesktop.getMainFrame.getFocusOwner;
jClassName = 'com.mathworks.mlwidgets.help.HelpPopup';
jPosition = java.awt.Rectangle(0,0,400,300);
helpTopic = 'surf';
javaMethodEDT('showHelp',jClassName,jTextArea,[],jPosition,helpTopic);

where:
1) jPosition sets popup’s pixel size and position (X,Y,Width,Height). Remember that Java counts from the top down (opposite to Matlab) and is 0-based. Therefore, Rectangle(0,0,400,300) is a 400×300 window at the screen’s top-left corner.

2) helpTopic is the help topic of your choice (the output of the doc function). To display arbitrary text, create an HTML doc page. A much easier alternative is to create a simple .m file that only has a main help comment with your arbitrary text, which will be presented in the popup.
Note: on pre-R2008a releases you need to use the equivalent but more cumbersome awtinvoke function instead of javaMethodEDT.

By: Dani

Dani — Thu, 26 Nov 2009 19:09:44 +0000

Another help viewer is the one that pops up when I click F1 on a marked Matlab keyword – I like the design of that one the most. Is it possible to (ab)use it and have it pop up with information of my choice? I cannot find out how it is called up.

By: Jason McMains

Jason McMains — Mon, 31 Aug 2009 18:31:46 +0000

works great, I had to do alot of modifying of the schema and other mfiles throughout to change uitab to uitab_new, but it was well worth it.

By: Yair Altman

Yair Altman — Thu, 27 Aug 2009 20:32:10 +0000

Jason – you can replicate the entire uitab/uitabgroup code base (m-files and their associated private folders) to a network-accessible central location, which you would then be able to modify.

You’ll need to ensure that your Matlab path uses the new location rather than the default one – perhaps the best way to ensure this is to simply rename the files (and associate private folders) to uitab_new/uitabgroup_new, or something similar.

By: Jason McMains

Jason McMains — Thu, 27 Aug 2009 18:39:27 +0000

@Yair,
Is there a way to reroute where that callback goes to something in the current directory? I’m deploying this on a network, so if others use it, they would have to update that location as well. (plus my company blocks us from modifying the matlab root directory )

Thanks Again
Jason

By: Yair Altman

Yair Altman — Thu, 27 Aug 2009 09:58:30 +0000

@Jason – the updateVisibility function is an m-file (%matlabroot%\toolbox\matlab\uitools\@uitools\@uitab\updateVisibility.m) that is responsible for hiding the previous tab’s components and unhiding the new tab’s components, whenever the active tab is changed (selected). Each tab is considered a “child” of the tabgroup and automatically has the updateVisibility() function defined as a private function. It appears that CSHelp adds extra children that do not have this updateVisibility() function defined.

I think the simplest workaround is simply to add a try-catch block around the offending line (%matlabroot%\toolbox\matlab\uitools\@uitools\@uitabgroup\schema.m line #211 [for Matlab R2008a]):

    try
        children(i).updateVisibility();
    catch
        % never mind...
    end

By: Andy

Andy — Mon, 17 Aug 2009 13:51:02 +0000

Wow, this is great. I’m not at MATLAB right now, so I can’t try this out, but it’s good to hear that helpview accepts any HTML file path, since I’ve spent about a week typing up full ‘Help’ documentation in HTML to be called via the web function. But using the web function to open my HTML pages doesn’t seem to give me the ability to easily control the help documentation (e.g. close the help window from within the GUI, open the help page to a specific section controlled by the user, etc.). It sounds like I’ll be able to do these things with cshelp and helpview.

Thanks for the detailed response!

By: Jason McMains

Jason McMains — Wed, 12 Aug 2009 12:07:44 +0000

Yair,
Thanks again, I’ve been looking for an ability like this for a while. The only thing I will point out is that this seems to have an adverse effect with the tabbed panels. When I turn on CSHelp and try to switch tabs I get the following error:

??? No appropriate method or public field updateVisibility for class hg.hgjavacomponent.

Error in ==> uitools.uitabgroup.schema>onSelChanged at 211
children(i).updateVisibility();

Any Ideas?
Thanks
Jason

By: Ashish Sadanadnan

Ashish Sadanadnan — Wed, 05 Aug 2009 19:50:24 +0000

Hi Yair,
This is completely off topic but you mentioned schema.prop and so I was hoping you’d be able to help with two posts I recently made on CSSM. No one has replied to either yet.

http://tinyurl.com/mt2ncl
http://tinyurl.com/nls6r4

The classes mentioned in the first post are using the schema.m mechanism.

Thanks for your help,
Ashish.