Share via


NM_HTMLCONTEXT

Send Feedback

This structure contains information about the target of an event inside an HTML viewer control. The HTML viewer control passes the container application a pointer to an NM_HTMLCONTEXT structure in the pnmHtmlContext parameter of the NM_CONTEXTMENU notification message.

Syntax

typedef struct tagNM_HTMLCONTEXT {
  NMHDR hdr;
  POINT pt;
  UINT uTypeFlags;
  LPTSTR szLinkHREF;
  LPTSTR szLinkName;
  DWORD dwUnused1;
  DWORD dwImageCookie;
  DWORD dwUnused2;
} NM_HTMLCONTEXT;

Members

  • hdr
    An NMHDR structure, specifying the type of notification message being sent and identifying the control that sent it.

  • pt
    A point that contains the screen coordinates of the event.

  • uTypeFlags
    Designates the type of object that the user selected. It is one of the values specified in the following table.

    Constant Description
    HTMLCONTEXT_BACKGROUND The target of the event is a background object. This could be anything other than a link or an image.
    HTMLCONTEXT_LINK The target of the event is an HTML link.
    HTMLCONTEXT_IMAGE The target of the event is an image.
    HTMLCONTEXT_IMAGENOTLOADED The target of the event is an image that has not been loaded yet.
  • szLinkHREF
    A null-terminated string that contains the URL of the link that the user selected. The value in this member is only valid if the HTMLCONTEXT_LINK flag is set in the uTypeFlags ** member.

  • szLinkName
    A null-terminated string that contains the NAME of the link that the user selected. The value in this member is only valid if the HTMLCONTEXT_LINK flag is set in the uTypeFlags ** member.

  • dwUnused1
    This member is no longer used. Set to zero.

  • dwImageCookie
    Specifies the cookie value that was originally passed from the application to the HTML viewer control in the dwCookie member of the INLINEIMAGEINFO structure referenced in the lParam of the DTM_SETIMAGE message. The value in this member is only valid if the HTMLCONTEXT_IMAGE flag is set in the uTypeFlags ** member.

  • dwUnused2
    This member is no longer used. Set to zero.

Remarks

Never modify any of the data inside the NM_HTMLCONTEXT structure. The HTML viewer control uses this data internally. Do not attempt to store or free any of the pointers contained in this structure. If you need to retain one of the strings for later use, make a copy of it.

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 Structures | NM_CONTEXTMENU | INLINEIMAGEINFO

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.