This content has been marked as final. Show 3 replies
Hi, Jane, and welcome,
I think your options are limited if you're using the HTML Help API. As I understand it, HH_DISPLAY_TEXT_POPUP can fetch the content of help pop-ups from either a plain-text file compiled into the .chm file or from the application code. Perhaps storing the help strings in the code itself may be a solution of sorts.
The following page provides the most detailed information I have seen anywhere on implementing What's This? help with HTML Help:
Your description of successfully invoking help in a secondary HTML Help window by passing ALink keywords suggests that you may have been using a different API command than HH_DISPLAY_TEXT_POPUP — maybe HH_ALINK_LOOKUP. Only HH_DISPLAY_TEXT_POPUP and HH_TP_HELP_CONTEXTMENU display help content in a borderless pop-up window.
You may want to look at KeyHelp, mentioned at some length in the Helpware page above. KeyHelp provides the means to call feature-rich, borderless HTML pop-ups from an application.
One other option would be to do away with What's This? help and instead provide dialog-level help, with descriptions of all the fields in a particular dialog box in a single help topic. This would be easier to implement, easier for the user to browse (at least, arguably), and in step with what many software vendors are doing nowadays. For instance, I think Microsoft has abandoned What's This? help in favour of dialog-level help in most of its recent products.
Thanks so much for that. KeyHelp certainly does look like it provides the functionality we are looking for. Whether our developers will be able to ship the ActiveX control with our code is the only potential showstopper that I can see, but it is definitely worth a shot. We will try it out before going down the route of dropping popup help altogether (the application has hundreds of multi-tabbed dialogs), although as you say, it seems Microsoft have already done this for their Office products.
I wonder if anyone else has implemented KeyHelp successfully? My only concern is future compatibility as I wouldn't want to have to find another solution later on after creating a lot of work for development and myself.
Anyhow, many thanks for the leads!
I forwarded your questions to the Microsoft Help MVPs and received the following responses:
quote:I don't personally know of anyone who is using KeyHelp for field-level help, but it does come from unimpeachable sources: Ralph Walden, formerly Microsoft's lead developer of both WinHelp and HTML Help, and Cheryl Lockett Zubak, a charter member of the Microsoft Help MVP programme.
From Dana Worley:
Never tried [KeyHelp], but I opted to just create a separate HTMLHelp window that sort of looks like a context sensitive popup (very little on the navigation bar -- Back, Forward, Print and that's it).
It was a lot easier and doesn't rely on special tools or an activeX control that might cause problems down the road (developer just has to call the right window).
From Rob Chandler:
... And the code for the KeyHelp Rich popups is very simple (well at least for programmer). If this guy wants to, he is free to contact me and I will help him with script and changing over to KeyHelp popups.
Hope that helps,