Help and Support
 

powered byLive Search

HOWTO: Use HTML Help API in a Visual Basic Application

Article ID:183434
Last Review:July 2, 2007
Revision:4.1
This article was previously published under Q183434

SUMMARY

This article describes the steps necessary to use the HTML Help API in a Visual Basic application.

Back to the top

MORE INFORMATION

The steps needed to use the HTML Help API in a Visual Basic application are:

1.Declare the HTML Help constants.
2.Declare the HtmlHelp() function.
3.Call the HtmlHelp() function with valid parameters.
The following code fragments demonstrate these steps:

1.The HTML Help constants are defined as follows:
      Const HH_DISPLAY_TOPIC = &H0
      Const HH_SET_WIN_TYPE = &H4
      Const HH_GET_WIN_TYPE = &H5
      Const HH_GET_WIN_HANDLE = &H6
      Const HH_DISPLAY_TEXT_POPUP = &HE   ' Display string resource ID or
                                          ' text in a pop-up window.
      Const HH_HELP_CONTEXT = &HF         ' Display mapped numeric value in
                                          ' dwData.
      Const HH_TP_HELP_CONTEXTMENU = &H10 ' Text pop-up help, similar to
                                          ' WinHelp's HELP_CONTEXTMENU.
      Const HH_TP_HELP_WM_HELP = &H11     ' text pop-up help, similar to
                                          ' WinHelp's HELP_WM_HELP.
						
2.The HtmlHelp() function is declared as follows:
      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.The following are examples of how to call the HTML Help API from Visual Basic:
      ' HTML Help file launched in response to a button click:
      Private Sub HH_DISPLAY_Click()
      'hWnd is a Long defined elsewhere to be the window handle
      'that will be the parent to the help window.
         Dim hwndHelp As Long
         'The return value is the window handle of the created help window.
         hwndHelp = HtmlHelp(hWnd, "myfile.chm", HH_DISPLAY_TOPIC, 0)
      End Sub

      ' A specific topic identified by the variable ContextID is launched
      ' in response to this button click:
      Private Sub HH_HELP_Click()
         Dim hwndHelp As Long
         'The return value is the window handle of the created help window.
        hwndHelp = HtmlHelp(hWnd, "myfile.chm", HH_HELP_CONTEXT, ContextID)
      End Sub

Back to the top

REFERENCES

HTML Help Workshop; Online Help
HTML Help Web Site:
http://msdn2.microsoft.com/en-us/library/ms670169.aspx (http://msdn2.microsoft.com/en-us/library/ms670169.aspx)

Back to the top


APPLIES TO
Microsoft Visual Basic 4.0 Professional Edition
Microsoft Visual Basic 4.0 32-Bit Enterprise Edition
Microsoft HTML Help 1.3

Back to the top

Keywords: 
kbcode kbhowto KB183434

Back to the top

Article Translations

 

Other Support Options

  • Need More Help?
    Contact a Support professional by Email, 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.