IHTMLDocument2::activeElement Property
Gets the object that has the focus when the parent document has focus.
Syntax
HRESULT IHTMLDocument2::get_activeElement(IHTMLElement **p);
Parameters
- p
- Address of a pointer to a variable of type IHTMLElement interface that receives the element that has the focus.
Return Value
Returns S_OK if successful, or an error value otherwise.
Remarks
You can set the active element with the setActive method or the focus method; however, using the setActive method has no effect on document focus. Use the focus method to cause an individual element to gain focus and become the active element.
The active element retains focus in the parent document even when focus is shifted from the parent to another application. If the focus returns to the parent document, focus also returns to the same active element.
Note For versions of Microsoft Internet Explorer 5 and later, the IHTMLDocument2::activeElement property is not defined until a document is loaded. A value of NULL is given for this property, if it is accessed inline during the loading of a document. This property can be accessed in the onload event handler function.
Note Internet Explorer 4.0 returns body as the IHTMLDocument2::activeElement when it is accessed inline during the loading of a document.
