onpropertychange Event

MS Office DHTML, HTML & CSS

 
Click to return to the DHTML, HTML & CSS home page    
onpaste Event     onreadystatechange Event     DHTML Events    

onpropertychange Event


Fires when a property changes on the object.

Syntax

Inline HTML <ELEMENTonpropertychange = "handler" ... > All platforms
Event property object.onpropertychange = handler JScript (compatible with ECMA 262 language specification) only
Named script <SCRIPT FOR = object EVENT = onpropertychange> Internet Explorer only

Remarks

Bubbles No
Cancels No
To invoke Cause a property to change value.
Default action Sends notification when a property changes.

The onpropertychange event fires when object, expando, or style subobject properties change. You can retrieve the name of the changed property by using the event object's propertyName property. This property returns a read-only string of the name of the property that has changed. In the case of style properties, the property name is prefixed with style. For example, if the CSS property pixelLeft is altered, the value of window.event.propertyName is style.pixelLeft. By contrast, if the non-CSS property name is altered, the value of window.event.propertyName is name.

When the onpropertychange event fires, the srcElement property of the event object is set to the object whose property has changed.

Event Object Properties

Although event handlers in the DHTML Object Model do not receive parameters directly, the handler can query the event object for data.

Event Object Properties

propertyNameRetrieves the name of the property that has changed on the object.
srcElementRetrieves the object that fired the event.
typeRetrieves the event name from the event object.

Example

This example shows how to use onpropertychange, srcElement, and propertyName for an object and a style subobject property to determine the name and value of an updated property.

Sample Code

<HEAD>
<SCRIPT>
function changeProp()
{
  oProp.value = "This is the new VALUE";
}

function changeCSSProp()
{
  oStyleProp.style.backgroundColor = "aqua";
}
</SCRIPT>
</HEAD>
<BODY ID=bdyChange>
<INPUT TYPE=button ID=oProp onclick="changeProp()"
   VALUE="Click to change the VALUE property of this button"
   onpropertychange='alert(event.srcElement.id + 
      " received a change to " + event.propertyName)'>
<INPUT TYPE=button ID=oStyleProp onclick="changeCSSProp()"
   VALUE="Click to change the CSS backgroundColor property 
      of this button"
   onpropertychange='alert(event.srcElement.id + 
      " received a change to " + event.propertyName)'>
</BODY>

This feature requires Internet Explorer 5 or later. Click the icon below to install the latest version. Then reload this page to view the sample.
Microsoft Internet Explorer

Applies To

[ Object Name ]
PlatformVersion
Win16:
Win32:
Mac:
Unix:
WinCE:
Version data is listed when the mouse hovers over a link, or the link has focus.
A, ADDRESS, APPLET, AREA, B, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, COMMENT, custom, DD, DFN, DIR, DIV, DL, document, DT, EM, EMBED, FIELDSET, FONT, FORM, Hn, HR, I, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=hidden, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, KBD, LABEL, LEGEND, LI, LISTING, MAP, MARQUEE, MENU, NOBR, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, S, SAMP, SCRIPT, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TR, TT, U, UL, VAR, XMP

See Also

propertyName, srcElement


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? write us!Internet Link

© 1999 microsoft corporation. all rights reserved. terms of useInternet Link.