NM_HOTSPOT

Article
08/28/2006

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