Sets or retrieves the width of the object in the units specified by the width attribute.

Syntax

HTML	N/A
Scripting	object.style.posWidth [ = iWidth ]

Possible Values

iWidth

Floating-point that specifies or receives any valid floating-point number that uses the same length units as the width attribute.

The property is read/write. The property has no default value. The Microsoft Cascading Style Sheets (CSS) extension is not inherited.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.

Remarks

This property reflects the value of the Cascading Style Sheets (CSS)?B>width attribute for positioned items. This property always returns zero for nonpositioned items because "width" has meaning only when the object is positioned. If the width attribute is not set, the posWidth property returns zero.

Setting the posWidth property changes the value of the width but leaves the units designator for the property unchanged.

Unlike the width property, the posWidth property value is a floating-point number, not a string.

For more information about how to access the dimension and location of objects on the page through the Dynamic HTML (DHTML) Document Object Model (DOM), see Measuring Element Dimension and Location.

Example

This example uses the posWidth property to increase the width of the first img object by 10 units.

<SCRIPT LANGUAGE="JScript">
document.all.tags("IMG").item(0).style.posWidth += 10;
</SCRIPT>

Standards Information

There is no public standard that applies to this property.

Applies To

A, ACRONYM, ADDRESS, APPLET, B, BASE, BASEFONT, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, CUSTOM, DD, defaults, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, HEAD, hn, HR, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, LINK, LISTING, MARQUEE, MENU, META, nextID, NOBR, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, Q, RT, RUBY, runtimeStyle, S, SAMP, SCRIPT, SELECT, SMALL, SPAN, STRIKE, STRONG, style, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TITLE, TR, TT, U, UL, VAR, XMP

See Also

pixelWidth