NM_INLINE_FRAME
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 Element and 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_HTMLVIEW structure that contains information about the NM_IMAGE_FRAME 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 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 FRAME 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 a FRAME 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 |