Share via


NM_INLINE_IFRAME

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 an IFRAME Element and gives the application a chance to bypass the operation.

Syntax

NM_IMAGE_IFRAME
NM_HTMLVIEW * pnmHTMLView = (NM_HTMLVIEW *)lParam;

Parameters

  • pnmHTMLView
    Points to an NM_HTMLVIEW structure that contains information about the NM_IMAGE_IFRAME notification message.

    The szTarget member 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 IFRAME.

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 an IFRAME element'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 an IFRAME element, 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

Reference

HTML Control API Notifications
NM_INLINE_FRAME