Help and Support
 

powered byLive Search

How To Add HTML Help to a Visual Basic 6.0 Application Wizard Application

Article ID:286404
Last Review:June 29, 2004
Revision:2.1
This article was previously published under Q286404

SUMMARY

This article describes how to add HTML Help to an application that was created using the Visual Basic 6.0 Application Wizard. When you choose to add Help to your menu or to your toolbar, the application wizard adds the necessary code for Winhelp. You need to change the code so that HTML Help is used instead of Winhelp.

Back to the top

MORE INFORMATION

After you build your application by using the application wizard, make the following changes:
1.Set the Project Properties Help filename. Select Project Properties on the Project menu to open the Project Properties dialog box. In the Help File Name field of the General tab, enter the path and file name for your application's HtmlHelp file. (You can also programmatically set the Help file. For more information see the MSDN topic "Adding Help To Your Application" in the "References" section.)
2.Replace the Winhelp declaration with an HTML Help declaration. To do this, replace the line that the wizard put at the top of frmMain. Replace this code
Private Declare Function OSWinHelp% Lib "user32" Alias "WinHelpA" (ByVal hwnd&, ByVal HelpFile$, ByVal wCommand%, _
                                                                   dwData As Any)
					
with this code:
Private Declare Function HtmlHelp Lib "hhctrl.ocx" Alias "HtmlHelpA" (ByVal hwndCaller As Long, ByVal pszFile As String, _
                                                                      ByVal uCommand As Long, ByVal dwData As Long) As Long
					
3.On the next line, add the HTML Help commands you are using. For example:
Private Const HH_DISPLAY_TOPIC = &H0
Private Const HH_HELP_CONTEXT = &HF
					
NOTE: For a complete list of all the commands, see the htmlhelp.h file in the "include" folder where the HTML Help Workshop is installed. For information about the command syntax, see the HTML Help online Help, API Reference.

4.If you chose to add Help to your menu during the application wizard, the wizard adds two methods, mnuHelpSearchForHelpOn_Click and mnuHelpContents_Click.

You need to replace the calls to Winhelp with calls to the HTML Help API in these methods. (The exact syntax of the commands varies depending on which commands you are using. See the HTML Help online Help for additional information regarding the API commands.) For example, you could replace this code
nRet = OSWinHelp(Me.hwnd, App.HelpFile, 261, 0)
					
with this code:
dim nRet As Long

nRet = HtmlHelp(Me.hwnd, App.HelpFile, HH_DISPLAY_TOPIC, 0)
					
5.If you chose to add Help as a toolbar button during the Application Wizard, the Wizard adds this to the tbToolBar_ButtonClick method:
Case "Help"
'ToDo: Add 'Help' button code.
MsgBox "Add 'Help' button code."
					
Remove the MsgBox call and add a call to the HTML Help API, such as:
dim nRet As Long
nRet = HtmlHelp(Me.hwnd, App.HelpFile, HH_DISPLAY_TOPIC, 0)
					
6.If you choose to add "Help What's This" as a toolbar button, then the wizard adds this to your code:
Case "Help What's This"
'ToDo: Add 'Help What's This' button code.
MsgBox "Add 'Help What's This' button code."  
					
Remove the MsgBox call and add a call to the HTML Help API using the 'HH_HELP_CONTEXT' command, such as:
 
hwndHelp = HtmlHelp(Me.hWnd, App.HelpFile, HH_HELP_CONTEXT, myContextID)
					
NOTE: Adding "What's This" help requires additional steps that are not covered in this article. For more information see the MSDN topic: "Adding Support for What's This Help".

Back to the top

REFERENCES

MSDN topic: "Adding Help To Your Application"
http://msdn.microsoft.com/library/devprods/vs6/vbasic/vbcon98/vbconAddingHelpToYourApplication.htm (http://msdn.microsoft.com/library/devprods/vs6/vbasic/vbcon98/vbconAddingHelpToYourApplication.htm)
HTML Help Workshop Online Help

Back to the top


APPLIES TO
Microsoft Visual Basic 6.0 Professional Edition
Microsoft HTML Help 1.2
Microsoft HTML Help 1.21
Microsoft HTML Help 1.22
Microsoft HTML Help 1.3
Microsoft HTML Help 1.31
Microsoft HTML Help 1.32

Back to the top

Keywords: 
kbhowto kbapi kbcompiler KB286404

Back to the top

Article Translations

 

Other Support Options

  • Need More Help?
    Contact a Support professional by E-mail, Online or Phone.
  • Customer Service
    For non-technical assistance with product purchases, subscriptions, online services, events, training courses, corporate sales, piracy issues, and more.
  • Newsgroups
    Pose a question to other users. Discussion groups and Forums about specific Microsoft products, technologies, and services.