DOC: WinHelp Function Expects a POINTS Structure

ID: Q167341

The information in this article applies to:

Microsoft Win32 Software Development Kit (SDK)

SUMMARY

The Remarks documentation for the function WinHelp() regarding the fourth parameter (DWORD dWord // other info) incorrectly states:

   HELP_SETPOPUP_POS  Sets the position of the subsequent pop-up window.
     Address of a POINTS structure. The pop-up window is positioned as if
     the mouse cursor were at the specified point when the pop-up window is
     invoked.

The function actually expects a POINTS structure, rather than an address to the structure. When you pass an address, a misplaced pop-up menu appears.

You can pass the information to WinHelp() by using the MAKELONG macro to set the fourth parameter as follows:

   dWord = MAKELONG(left,top)

where the two parameters represent the desired positions of the pop-up menu.

Additional query words: HELP_SETPOPUP_POS WinHelp POINTS

Keywords          : kbdocerr kbfasttip
Platform          : NT WINDOWS

Last Reviewed: May 21, 1998