DTM_IMAGEFAIL

Article
08/28/2006

This message is sent by an application to inform the HTML control that the image indicated by the cookie could not be loaded. The cookie value is the value referenced by the dwCookie member of the INLINEIMAGEINFO structure that was sent with the DTM_SETIMAGE message.

Syntax

DTM_IMAGEFAIL
  wParam = 0;
  lParam = (LPARAM)(DWORD) dwCookie;

Parameters

dwCookie
Indicates that the load image that could not be loaded. This value is passed in the dwCookie member of the NM_HTMLVIEW structure when an NM_INLINE_IMAGE notification message is received. This is the same value that was passed in the dwCookie member of the INLINEIMAGEINFO structure when the DTM_SETIMAGE message was sent to the HTML control.

Return Values

None.

Remarks

The Image loading icon will be replaced with the broken image icon, and the ALT text will be displayed.

This topic is also documented in the Microsoft® Windows® CE SDK. Only the requirements table has changed.

The following example shows how you might use this message.

SendMessage(hWndCtrl, DTM_IMAGEFAIL, 0, ((NM_HTMLVIEW *)lParam)->dwCookie);

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

Share via