width property

Article
05/02/2017

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 IHTMLCurrentStyle::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, IHTMLCurrentStyle::paddingLeft, and IHTMLCurrentStyle::paddingRight. Subtracting the sum of the values of these properties from the value of the IHTMLCurrentStyle::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 IHTMLCurrentStyle::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, IHTMLCurrentStyle::paddingLeft, and IHTMLCurrentStyle::paddingRight. Subtracting the sum of the values of these properties from the value of the IHTMLCurrentStyle::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 IHTMLCurrentStyle::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