longDesc property

  • Article

[This documentation is preliminary and is subject to change.]

Sets or retrieves a Uniform Resource Identifier (URI) to a long description of the object.

Syntax

HRESULT value = object.put_longDesc(BSTR v);HRESULT value = object.get_longDesc(BSTR* p);

Property values

Type: BSTR

the URI.

Standards information

Remarks

The long description supplements the shorter description specified by the IHTMLInputElement::alt attribute.

Windows Internet Explorer 8 or later. In IE8 Standards mode, the value of the IHTMLImgElement2::longDesc attribute for the frame, iframe, and img elements depends on the context of the reference to the attribute. When read as a Document Object Model (DOM) attribute, IHTMLImgElement2::longDesc returns an absolute URL. The value specified by the page author is returned when IHTMLImgElement2::longDesc is read as a content attribute, when the page is displayed in an earlier document compatibility mode, or when the page is viewed with an earlier version of the browser. For more information, see Attribute Differences in Internet Explorer 8.

The IHTMLInputElement::alt attribute is no longer displayed as the image tooltip for pages displayed in IE8 mode. The target of the IHTMLImgElement2::longDesc attribute is now displayed as the tooltip, if present; otherwise, the IHTMLElement::title is displayed. However, the IHTMLInputElement::alt attribute is displayed as the Microsoft Active Accessibility (MSAA) tooltip. If this attribute is not present, the title attribute is displayed instead. For more information, see Accessibility section in What's New in Internet Explorer 8.

IHTMLImgElement2::longDesc was introduced in Microsoft Internet Explorer 6.

 

 

Build date: 6/12/2012