IHTMLImgElement Interface

---

This interface provides access to some of the properties and methods supported by the IMG element and the INPUT element of the image type. The other properties and methods are accessible through the IHTMLImgElement interface.

IHTMLImgElement Methods

get_align	Retrieves how the element is aligned with adjacent text.
get_alt	Retrieves the optional text as an alternative to the graphic for rendering in nongraphical environments. Alternate text should be provided whenever the graphic is not rendered. Alternate text is mandatory for Level 0 documents.
get_border	Retrieves the current thickness of the border around the element in pixels.
get_complete	Retrieves the value that indicates whether the specified element is fully loaded.
get_dynsrc	Retrieves the address of a video clip or VRML world to be displayed in the window. Stands for Dynamic Source.
get_fileCreatedDate	Retrieves the creation date of the image file associated with the element.
get_fileModifiedDate	Retrieves the date when the image file associated with the element was most recently modified.
get_fileSize	Retrieves the size, in bytes, of the image file associated with the element.
get_fileUpdatedDate	Retrieves the date when the image file associated with the element was last updated.
get_height	Retrieves the calculated height of the element, in pixels.
get_href	Retrieves the entire URL that the browser uses to locate the image or video clip associated with the element.
get_hspace	Retrieves the horizontal margins for the element in pixels.
get_isMap	Retrieves the value that indicates whether the picture is a server-side image map.
get_loop	Retrieves the number of times a video loops when activated.
get_lowsrc	Retrieves the URL of a lower-resolution image to display.
get_mimeType	Retrieves the MIME type for the file.
get_name	Retrieves the name of the control.
get_nameProp	Retrieves the file name from the URL that the browser uses to locate the image or video clip associated with the element.
get_onabort	Retrieves a pointer to the event handler function associated with the onabort event for an IMG element. The onabort event occurs when the user aborts the download of the image.
get_onerror	Retrieves a pointer to the event handler function associated with the onerror event for an IMG element. The onerror event occurs when the loading of a document or image causes an error.
get_onload	Retrieves a pointer to the event handler function associated with the onload event for an IMG element. The onload event occurs immediately after the browser loads the given object.
get_protocol	Retrieves the protocol portion of the URL that the browser uses to locate the image or video clip associated with the element. The protocol portion, which indicates the access method, includes the initial substring of the URL up to and including the first colon.
get_readyState	Retrieves the current state of an object being downloaded.
get_src	Retrieves the URL of an image to be shown.
get_start	Retrieves when a video clip should start playing.
get_useMap	Retrieves the URL used as a client-side image map. The URL includes the bookmark extension (#name), if any.
get_vrml	Retrieves the URL of the VRML world to be displayed in the window.
get_vspace	Retrieves the vertical margins for the element in pixels.
get_width	Retrieves the calculated width of the element, in pixels.
put_align	Sets how the element is aligned with adjacent text.
put_alt	Indicates optional text as an alternative to the graphic for rendering in nongraphical environments. Alternate text should be provided whenever the graphic is not rendered. Alternate text is mandatory for Level 0 documents.
put_border	Sets the thickness of the border around the element in pixels.
put_dynsrc	Sets the address of a video clip or VRML world to be displayed in the window. Stands for Dynamic Source.
put_height	Sets the calculated height of the element, in pixels.
put_hspace	Sets the horizontal margins for the element in pixels.
put_isMap	Sets the value that indicates whether the picture is a server-side image map.
put_loop	Sets the number of times a video will loop when activated.
put_lowsrc	Sets the URL of a lower-resolution image to display.
put_name	Sets the name of the element.
put_onabort	Sets a pointer to the event handler function associated with the onabort event for an IMG element. The onabort event occurs when the user aborts the download of the image.
put_onerror	Sets a pointer to the event handler function associated with the onerror event for an IMG element. The onerror event occurs when the loading of a document or image causes an error.
put_onload	Sets a pointer to the event handler function associated with the onload event for an IMG element. The onload event occurs immediately after the browser loads the given object.
put_src	Sets the URL of an image to be shown.
put_start	Specifies when a video clip file should start playing.
put_useMap	Sets a URL, often with a bookmark extension (#name), to use as a client-side image map.
put_vrml	Specifies the URL of a VRML world to be displayed in the window.
put_vspace	Sets the vertical margins for the element in pixels.
put_width	Sets the calculated width of the element, in pixels.

Interface Information

Implementation	System (Mshtml.dll)
Inherits from	IDispatch
Header and IDL files	Mshtml.h, Mshtml.idl
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows 95, Windows NT 4.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

Remarks

The IMG element embeds an image or a video clip in a document. It supports the onfocus event and can receive the input focus only if it has been associated with a MAP element.