onactivate event

Fires when the object is set as the IHTMLDocument2::activeElement.


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

Event information

Synchronous No
Bubbles Yes
Cancelable No

Event handler parameters

  • pEvtObj [in]
    Type: [IHTMLEventObj](aa703876(v=vs.85).md)

Standards information

There are no standards that apply here.


Note 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.

When one object loses activation and another object becomes the IHTMLDocument2::activeElement, the HTMLTableEvents2::onfocus event fires on the object becoming the IHTMLDocument2::activeElement only after the HTMLTableEvents2::onblur event fires on the object losing activation.

Each document may have up to one active element. Set the active element with the IHTMLElement3::setActive or IHTMLElement2::focus methods.

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 Microsoft Internet Explorer 6 and later, the event.IHTMLEventObj::fromElement property is now exposed by this event.

For Microsoft Internet Explorer 5.5 and later, focus on a document, and the IHTMLDocument2::activeElement of a document can be managed separately. Use the HTMLTableEvents2::onactivate event to manage formatting changes when an element is made active.

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

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