NM_HTMLVIEWA

4/8/2010

This structure is pointed to by the LPARAM of the WM_NOTIFY message sent by the HTML control. The NMHDR is the standard notification structure that contains information about the instance (HWND, and so on) sending the notification message. The definitions of the szTarget, szData, and dwCookie members vary with the specific HTML Control notification message.

Syntax

typedef struct tagNM_HTMLVIEWA {
  NMHDR hdr;
  LPCSTR szTarget;
  LPCSTR szData;
    union {
      DWORD dwCookie;
      DWORD dwFlags;
    };
  LPCSTR szExInfo;
} NM_HTMLVIEWA;

Members

• hdr
  An NMHDR structure identifying the window sending the notification message.

• szTarget
  A null-terminated string whose usage is unique to the notification message, as shown in the following table.

  Value	Description
  NM_HOTSPOT	String that contains the contents of the HREF attribute in the HTML text.
  NM_INLINE_IMAGE	String that contains the text from the SRC attribute of the IMG tag in the HTML text.
  NM_INLINE_SOUND	String that contains the text from the SRC attribute of the BGSOUND tag in the HTML text.
  NM_INLINE_STYLE	String that contains the name of a style sheet using the ANSI character set.
  NM_META	String that contains the contents of the HTTP-EQUIV attribute of the META tag in the HTML document.
  NM_TITLE	String that contains the title of the HTML document.
  NM_BASE	String that contains the contents of the HREF attribute of the BASE tag in the HTML text.
  NM_INLINE_XML	String that contains the contents of the SRC attribute of the XML tag in the HTML text.
  NM_BEFORENAVIGATE	String that contains the URL of the HTML control navigation.
  NM_DOCUMENTCOMPLETE	String that contains the URL of the HTML control navigation.
  NM_NAVIGATECOMPLETE	String that contains the URL of the HTML control navigation.
  NM_TITLECHANGE	String that contains the title change of the HTML document.

• szData
  A null-terminated string whose usage is unique to the notification message, as shown in the following table.

  Value	Description
  NM_HOTSPOT	String that contains the query data for a POST form submission.
  NM_INLINE_IMAGE	Not used.
  NM_INLINE_SOUND	Not used.
  NM_INLINE_STYLE	Not used.
  NM_META	String that contains the contents of the CONTENT parameter of the META tag in the HTML document.
  NM_TITLE	Not used.
  NM_BASE	String that contains the contents of the TARGET attribute of the BASE tag in the HTML text.
  NM_INLINE_XML	String that contains the contents of the ASYNC attribute of the XML tag in the HTML text.
  NM_BEFORENAVIGATE	String that contains the POST data of the HTML control navigation.
  NM_DOCUMENTCOMPLETE	Not used.
  NM_NAVIGATECOMPLETE	Not used.
  NM_TITLECHANGE	Not used.

• dwCookie
  Contains a value whose usage is unique to the notification message, as shown in the following table.

  Value	Description
  NM_HOTSPOT	Not used.
  NM_INLINE_IMAGE	Cookie value that must be passed from the application to the HTML control in the DTM_SETIMAGE or DTM_IMAGEFAIL message.
  NM_INLINE_SOUND	Loop count value from the LOOP attribute of the BGSOUND tag.
  NM_INLINE_STYLE	Not used.
  NM_META	Not used.
  NM_TITLE	Not used.
  NM_BASE	Not used.
  NM_INLINE_XML	IXMLDOMDocument (see MSXML documentation for more information) pointer of the XML document for the XML data island.
  NM_BEFORENAVIGATE	Not used.
  NM_DOCUMENTCOMPLETE	Not used.
  NM_NAVIGATECOMPLETE	Not used.
  NM_TITLECHANGE	Not used.

• dwFlags
  Contains a value whose usage is unique to the notification message, as shown in the following table.

  Value	Description
  NM_HOTSPOT	Not used.
  NM_INLINE_IMAGE	Not used.
  NM_INLINE_SOUND	Not used.
  NM_INLINE_STYLE	Not used.
  NM_TITLE	Not used.
  NM_BASE	Not used.
  NM_INLINE_XML	Not used.
  NM_BEFORENAVIGATE	Contains the NAVIGATEFLAG used by the DTM_NAVIGATE message, as described in the NM_BEFORENAVIGATE notification message.
  NM_DOCUMENTCOMPLETE	Not used.
  NM_NAVIGATECOMPLETE	Not used.
  NM_TITLECHANGE	Not used.

• szExInfo
  A null-terminated string whose usage is unique to the notification message, as shown in the following table.

  Value	Description
  NM_HOTSPOT	String that contains the contents of the TARGET attribute in the HTML text.
  NM_INLINE_IMAGE	Not used.
  NM_INLINE_SOUND	Not used.
  NM_INLINE_STYLE	Not used.
  NM_META	Not used.
  NM_TITLE	Not used.
  NM_BASE	Not used.
  NM_INLINE_XML	Not used.
  NM_BEFORENAVIGATE	String that contains the headers sent to the server for the navigation.
  NM_DOCUMENTCOMPLETE	Not used.
  NM_NAVIGATECOMPLETE	Not used.
  NM_TITLECHANGE	Not used.

Requirements

See Also

Reference

HTML Control API Structures
NM_HOTSPOT
NM_INLINE_IMAGE
NM_INLINE_SOUND
NM_META
NM_TITLE
NM_BASE
NM_INLINE_XML
NM_BEFORENAVIGATE
NM_DOCUMENTCOMPLETE
NM_NAVIGATECOMPLETE
NM_TITLECHANGE