This content has been marked as final. Show 12 replies
If the old help is still showing, obviously something is amiss, no?
You say that you have removed the .CNT and .HLP files. But from where? Did you simply delete them from your PC? Or are you also the person responsible for developing the installer application for installing your company's application and help?
Thanks for getting back to me so quickly! I removed the .CNT and .HLP files from the folder containing the app files. They are still on my computer but in a separate folder on the C:\ drive rather than in the app folder in Program Files. Do they need to be completely removed from my PC?
No, I don't develop the installer app. Would that app point to the old Help? Our developer thought that simply replacing the Help files would suffice.
Indeed if you are using an application to install your company's application, it will need to be aware of your new files. So you need to get your CHM file(s) into the hands of the person that maintains that application.
However, I'm guessing that once you cross this hurdle, you will likely STILL have an issue. Here's why.
Your developer's statement of: Our developer thought that simply replacing the Help files would suffice. is worrisome, to say the least. This is because if you are switching from WinHelp (.HLP and .CNT files) to Compiled HTML Help (.CHM files) the calls issued from the application will most likely change.
Let's step away from the help arena for a bit and step into a different realm that may help you to better visualize/understand things. Consider that your application is like an electric stove. When the help is opened, the stove is expecting to use electricity. The problem here is one of connections. Essentially you have replaced the old help (electricity) with a new type of hep (natural gas). As a result, you must now run a gas line and change the stove (your application) so that it understands how to use natural gas.
In other words, it's never as simple as dropping a .CHM in where a .HLP existed and expecting it to work. The application needs to understand it is looking now for a .CHM instead. And your developer should know that.
Cheers and good luck... Rick
That makes sense, even without the stove illustration. Unfortunately, our developer inherited this project as did I and doesn't fully understand how the Help files work with the app files. You're right, he should know that, but he doesn't. And he is the one who maintains the install app as well. I'll try to talk to him again. Thanks for your help.
Just to add that it ought to be fairly quick and straightforward for your developer to change the old WinHelp API calls to HTML Help API calls. Microsoft modelled the HTML Help API on the WinHelp API in order to simplify the process of updating existing applications from WinHelp to HTML Help.
For example, a typical WinHelp API command looks like this:
WinHelp(HWnd, "helpfile.hlp", HELP_CONTEXT, 1001)
The HTML Help API equivalent is almost the same:
HtmlHelp(HWnd, "helpfile.chm", HH_HELP_CONTEXT, 1001)
Perhaps the following resources will help your developer:
Thanks, Pete! I'll pass this on to him.
Our developer has been unsuccessful calling the .CHM help file within our application. He has added the new library, changed the path to the Help file, specified that he wants to use the HTML Help, and changed the call from WinHelp to HTML Help. He still gets a general error message when he tries to launch the Help, saying it cannot be opened.
What are we missing? What's the solution? Or, barring that, how about some ideas as to what the problem is?
If you can find out which programming language the developer is using, we may be able to point him towards specific code samples, documentation, etc.
Thanks for responding. I should have mentioned...C++
As I understand it, your developer has to link to the library file (Htmlhelp.lib), and include the file Htmlhelp.h in his program. These files come with HTML Help Workshop, if he doesn't already have them.
Here are some links to resources that may help:
HTML Help MFC Code Sample
"Connecting HTML Help to C++/MFC Programs" white paper
Microsoft: "How to set up Visual C++ to use the HTML Help API"
I replied to this last week but don't see the reply listed. Thanks, Pete. Our developer added the library, but I don't think he'd added the Htmlhelp.h file. The links look helpful. I passed everything on to him. Will let you know if it still doesn't work.