This topic has not yet been rated - Rate this topic

onpropertychange event

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

Fires when a property changes on the object.

Syntax

HTML Attribute	<element onpropertychange = "handler(event)">
Event Property	object.onpropertychange = handler;
attachEvent Method	object.attachEvent("onpropertychange", handler)

Standards information

There are no standards that apply here.

Event information

Synchronous	No
Bubbles	No
Cancelable	No

Event handler parameters

pEvtObj [in]: Type: IHTMLEventObj

Remarks

The HTMLDocumentEvents2::onpropertychange event fires when properties of an object, IHTMLDocument2::expando, or style sub-object change. To retrieve the name of the changed property, use 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 Cascading Style Sheets (CSS) properties, the property name is prefixed with style. For example, if the CSS property IHTMLStyle::pixelLeft is altered, the value of window.event.propertyName is style.left. By contrast, if the non-CSS property IHTMLFrameBase::name is altered, the value of window.event.propertyName is name.

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

Note Changing the IHTMLElement::innerText or IHTMLElement::innerHTML of child elements will not cause the HTMLDocumentEvents2::onpropertychange event to fire for the parent element.

Sends notification when a property changes.

To invoke this event, do one of the following:

Cause a property to change value.

The pEvtObj parameter is required for the following interfaces: