NM_HOTSPOT

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

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.

Requirements

See Also

Reference

HTML Control API Notifications
DTM_ANCHOR
NM_HTMLVIEWA
NM_HTMLVIEWW