NM_HTMLCONTEXT

This structure contains information about the target of an ALT+Tap 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.

typedef struct tagNM_HTMLCONTEXT {
NMHDR hdr; 
POINT pt;
UINT uTypeFlags;
LPSTR szLinkHREF;
LPSTR szImageSrc;
HBITMAP hbmImage;
DWORD dwImageCookie;
} NM_HTMLCONTEXT;

Members

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

  • pt
    Point that contains the screen coordinates of the event.

  • uTypeFlags
    Desginates the type of object on which the user ALT+Tapped. It is one of the following values:

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

  • szImageSrc
    Null-terminated string that contains the source URL of the image that is the target of the ALT+Tap event. The value in this member is only valid if the HTMLCONTEXT_IMAGE flag is set in the uTypeFlags member*.*

  • hbmImage
    Handle to the bitmap associated with the image on which the user ALT+Tapped. The value in this member is only valid if the HTMLCONTEXT_IMAGE flag is set in the uTypeFlags member.

  • 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.

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

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Htmlctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

NM_CONTEXTMENU, INLINEIMAGEINFO, NMHDR

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.