NM_HOTSPOT
This notification message is sent by the HTML viewer control if the user selects a link or submits a form.
Syntax
NM_HOTSPOT
NM_HTMLVIEW * pnmHTMLView = (NM_HTMLVIEW *)lParam;
szHREFText = pnmHTMLView->szTarget;
szPostData = pnmHTMLView->szData;
Parameters
- pnmHTMLView
Points to an NM_HTMLVIEW structure that contains information about the NM_HOTSPOT notification message. - szHREFText
A null-terminated string that contains the contents of the HREF field in the HTML text. - szPostData
A null-terminated string that contains the query data for a POST form submission.
Return Values
If the application handles this message it should return a non-zero result. A non-zero return results in two NM_HOTSPOT notifications for FORM submissions. Passing a zero result to the HTML control will result in the default control handling to occur.
Remarks
The szTarget member of the NM_HTMLVIEW structure will contain the HREF text. On the click from an anchor, the HREF text will be the contents of the HREF field. For a GET form submission, the HREF text will include the form query data. For a POST form submission, the HREF text will include only the base that is contained in the <FORM> tag, and the query data will be passed in the szData member of the NM_HTMLVIEW structure.
For a FORM submission caused by a button, the application will may receive two NM_HOTSPOT notifications. One for the button click, which the application can return a zero value indicating that the submit should not occur. If the application returns a non-zero value from first NM_HOTSPOT a subsequent NM_HOTSPOT will occur for the FORM submit.
This topic is also documented in the Microsoft® Windows® CE SDK. Only the requirements table and the Return Values have changed.
Requirements
Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: htmlctrl.h
Library: htmlctrl.lib
See Also
HTML Control API Notifications | DTM_ANCHOR | NM_HTMLVIEWA | NM_HTMLVIEWW
Send Feedback on this topic to the authors