VML Imagedata Element

This topic describes VML, a feature that is deprecated as of Windows Internet Explorer 9. Webpages and applications that rely on VML should be migrated to SVG or other widely supported standards.


As of December 2011, this topic has been archived. As a result, it is no longer actively maintained. For more information, see Archived Content. For information, recommendations, and guidance regarding the current version of Windows Internet Explorer, see Internet Explorer Developer Center.


Defines an image for a shape.

The following attributes modify an image.

Attribute Description
AltHRef Specifies an alternate reference for an image.
Bilevel Determines whether an image will display in black and white.
BlackLevel Determines the intensity of black in an image.
Chromakey Defines the color in the palatte that will be treated as transparent.
CropBottom Defines the percentage of picture removal from the bottom side.
CropLeft Defines the percentage of picture removal from the left side.
CropRight Defines the percentage of picture removal from the right side.
CropTop Defines the percentage of picture removal from the top side.
DetectMouseClick Determines whether a mouse click will be detected.
EmbossColor Defines the color for embossed color effects.
Gain Defines the intensity of all colors in an image.
Gamma Defines the amount of contrast for an image.
GrayScale Determines whether a picture will display in grayscale mode.
HRef Defines a URL for an image.
ID Defines a unique identifier for an image.
Movie Defines a pointer to a movie image.
OLEID Stores the OLE ID of an image.
Src Defines a source for the image.
Title Defines the title of an image.



This element must be defined within a Shape element.

In addition, the Src attribute must point to an image.

The following is the minimum code needed to produce an image.

   <v:imagedata src="../art/kids.jpg"/>


In pre-release versions of VML, this element was called Image .