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 to notify the application that a URL is about to be loaded by a FRAME Elementand gives the application a chance to bypass the operation.

Syntax 

NM_IMAGE_FRAME
NM_HTMLVIEW * 
pnmHTMLView = (NM_HTMLVIEW *)lParam;

Parameters

pnmHTMLView

Points to an NM_HTMLVIEWstructure that contains information about the NM_IMAGE_FRAMEnotification message.

The szTargetmember of this structure will contain a null-terminated string that contains the contents of the SRC attribute of the <frame> tag.

Property Value/Return Value

If the application handles this message, it should return a non-zero result. The HTML control will not load the specified URL in that case. Returning a zero result to the HTML control will result in the default control handling to occur and the specified URL to be loaded into the FRAME.

Remarks

An application hosting an HTML control would respond to this message when it wants to prevent the control from making a network request to retrieve a FRAMEelement's contents from the URL of its 'src' attribute.

For example, consider an application that displays a previously-download HTML page while the device is offline. If that HTML page contained a FRAMEelement, the HTML control could try to make a network connection and retrieve its URL from the network, which may not be appropriate for the application. By responding to this notification, the host can prevent this network activity.

Requirements

Header htmlctrl.h
Library htmlctrl.lib
Windows Mobile Windows Mobile 6 and later

See Also