onactivate event
Fires when the object is set as the IHTMLDocument2::activeElement.
Syntax
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
Standards information
There are no standards that apply here.
Remarks
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 HTMLAnchorEvents::onfocus event fires on the object becoming the IHTMLDocument2::activeElement only after the HTMLAnchorEvents::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 HTMLAnchorEvents::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:
- HTMLAnchorEvents2
- HTMLAreaEvents2
- HTMLButtonElementEvents2
- HTMLControlElementEvents2
- HTMLDocumentEvents2
- HTMLElementEvents2
- HTMLFormElementEvents2
- HTMLImgEvents2
- HTMLFrameSiteEvents2
- HTMLInputFileElementEvents2
- HTMLInputImageEvents2
- HTMLInputTextElementEvents2
- HTMLLabelEvents2
- HTMLLinkElementEvents2
- HTMLMapEvents2
- HTMLMarqueeElementEvents2
- HTMLObjectElementEvents2
- HTMLOptionButtonElementEvents2
- HTMLScriptEvents2
- HTMLSelectElementEvents2
- HTMLStyleElementEvents2
- HTMLTableEvents2
- HTMLTextContainerEvents2
- HTMLWindowEvents2
See also
Reference
HTMLAnchorEvents::onbeforeactivate
HTMLAnchorEvents::onbeforedeactivate