Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

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_HTMLVIEWstructure 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 Value

If the application handles this message it should return a non-zero result. A non-zero return results in two NM_HOTSPOTnotifications for FORM submissions. Passing a zero result to the HTML control will result in the default control handling to occur.

Remarks

The szTargetmember of the NM_HTMLVIEWstructure 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 szDatamember of the NM_HTMLVIEWstructure.

For a FORM submission caused by a button, the application will may receive two NM_HOTSPOTnotifications. 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_HOTSPOTa subsequent NM_HOTSPOTwill occur for the FORM submit.

Requirements

Header htmlctrl.h
Library htmlctrl.lib
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also