width property

Specifies the width of the object.

Syntax

Integer value = object.put_width(Variant v);Integer value = object.get_width(Variant* sWidth);

Property values

Type: VARIANT

auto (auto)

Default. Default width of the object.

width (width)

Floating-point number, followed by an absolute units designator (cm, mm, in, pt, or pc) or a relative units designator (em, ex, or px). For more information about the supported length units, see CSS Values and Units Reference.

percentage (percentage)

Integer, followed by a %. The value is a percentage of the width of the parent object, whether or not it is specified explicitly. Negative values are not allowed.

String format

auto | width | percentage

CSS information

Applies To All elements
Media visual
Inherited no
Initial Value auto

Remarks

As of Microsoft Internet Explorer 6, when you use the !DOCTYPE declaration to specify standards-compliant mode, this property specifies the distance between the left and right edges of the content box—that is, within the IHTMLRuleStyle::padding.

When the !DOCTYPE declaration does not specify standards-compliant mode, and with earlier versions of Windows Internet Explorer, this property includes the object's content box, plus the values of the following properties: IHTMLRuleStyle::borderLeft, IHTMLRuleStyle::borderRight, IHTMLRuleStyle::paddingLeft, and IHTMLRuleStyle::paddingRight. Subtracting the sum of the values of these properties from the value of the IHTMLRuleStyle::width property equals the width of the parent object's content box.

When you use the !DOCTYPE declaration to specify standards-compliant mode, this property specifies the distance between the left and right edges of the content box—that is, within the IHTMLRuleStyle::padding.

When the !DOCTYPE declaration does not specify standards-compliant mode, this property includes the object's content box, plus the values of the following properties: IHTMLRuleStyle::borderLeft, IHTMLRuleStyle::borderRight, IHTMLRuleStyle::paddingLeft, and IHTMLRuleStyle::paddingRight. Subtracting the sum of the values of these properties from the value of the IHTMLRuleStyle::width property equals the width of the parent object's content box.

To perform operations on the numeric value of this property, use IHTMLStyle::pixelWidth or IHTMLStyle::posWidth.

For more information about how to access the dimension and location of elements on the page through the Dynamic HTML (DHTML) Document Object Model (DOM), see Measuring Element Dimension and Location with CSSOM in Internet Explorer 9.

Examples

In the HTML and CSS examples below, the width of the three div elements are set to different values using the IHTMLRuleStyle::width property. The width property is set to auto, the default value, for the first div, 350px for the second div, and 20% for the third div, or 20% of the width of the parent object.

<div id="one">
   Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt  
</div>
<div id="two">
   Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt  
</div>
<div id="three">
   Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt  
</div>
#one {
   width: auto;
   color: black;
}
#two { 
   width: 350px;
   color: navy;
}
#three {
   width: 20%;
   color: red;
}

You can see the result below.

This example uses inline scripting to set the width of an image when an HTMLFrameSiteEvents::onclick event occurs.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/width_s.htm

<img src="sphere.jpg" onclick="this.style.width='1cm'" ondblclick="this.style.width=''">

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

Conceptual

Measuring Element Dimension and Location with CSSOM in Internet Explorer 9

Other Resources

CSS Enhancements in Internet Explorer 6