Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ondeactivate event

Fires when the IHTMLDocument2::activeElement is changed from the current object to another object in the parent document.

Syntax

HTML Attribute <element ondeactivate = "handler(event)">
Event Property object.ondeactivate = handler;
attachEvent Method object.attachEvent("ondeactivate", handler)
addEventListener Method object.addEventListener("deactivate", handler, useCapture)

Event information

SynchronousNo
BubblesYes
CancelableNo

Event handler parameters

pEvtObj [in]

Type: IHTMLEventObj

Standards information

There are no standards that apply here.

Remarks

Note  When focus leaves the document, the active element does not change and the HTMLFrameSiteEvents2::onbeforedeactivate event will not fire.

Each document may have up to one active element. Set the active element with the IHTMLElement3::setActive or IHTMLElement2::focus methods. Using the IHTMLElement3::setActive method has no effect on document focus. Using the IHTMLElement2::focus method on an individual element causes the element to gain focus and become the active element.

Using the IHTMLElement2::focus method on a document that does not have the focus moves the document to the front of the display. Additionally, the document's active element gains focus.

For a given display, only one element has focus at any given time. Striking a key directly affects only the element with focus. Events fired by that keystroke may be scripted to affect other documents and child elements.

For Microsoft Internet Explorer 6 and later, the event.IHTMLEventObj::toElement property is now exposed by the HTMLFrameSiteEvents2::ondeactivate event.

With Microsoft Internet Explorer 5.5 and later, focus on a document, and the IHTMLDocument2::activeElement of a document can be managed separately. Use the HTMLFrameSiteEvents2::ondeactivate event to manage formatting changes when a element loses activation.

Change activation from the event.IHTMLEventObj::srcElement to the event.IHTMLEventObj::toElement.

To invoke this event, do one of the following:

  • Click an element, other than the IHTMLDocument2::activeElement element of the document.
  • Use the keyboard to move focus from the active element to another element.
  • Invoke the IHTMLElement3::setActive method on an element, when the element is not the active element.

The pEvtObj parameter is required for the following interfaces:

See also

Reference
HTMLFrameSiteEvents2::onbeforedeactivate
HTMLFrameSiteEvents2::onbeforeactivate
HTMLFrameSiteEvents2::onactivate
HTMLFrameSiteEvents2::onfocusin
HTMLFrameSiteEvents2::onfocusout

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.