nsIWebBrowserFocus

IID:9c5d3c58-1dd1-11b2-a1c9-f3699284657a
Inherits From:nsISupports
Status:FROZEN

Interface that embedders use for controlling and interacting with the browser focus management. The embedded browser can be focused by clicking in it or tabbing into it. If the browser is currently focused and the embedding application's top level window is disabled, deactivate() must be called, and activate() called again when the top level window is reactivated for the browser's focus memory to work correctly.

This interface is implemented by the following components:


Properties

nsIDOMElement focusedElement

The currently focused nsDOMElement when the browser is active, or the last focused nsDOMElement when the browser is inactive.

nsIDOMWindow focusedWindow

The currently focused nsDOMWindow when the browser is active, or the last focused nsDOMWindow when the browser is inactive.


Methods

void activate ( ) void deactivate ( ) void setFocusAtFirstElement ( ) void setFocusAtLastElement ( )

void activate ( )

MANDATORY activate() is a mandatory call that must be made to the browser when the embedding application's window is activated *and* the browser area was the last thing in focus. This method can also be called if the embedding application wishes to give the browser area focus, without affecting the currently focused element within the browser.


void deactivate ( )

MANDATORY deactivate() is a mandatory call that must be made to the browser when the embedding application's window is deactivated *and* the browser area was the last thing in focus. On non-windows platforms, deactivate() should also be called when focus moves from the browser to the embedding chrome.


void setFocusAtFirstElement ( )

Give the first element focus within mozilla (i.e. TAB was pressed and focus should enter mozilla)


void setFocusAtLastElement ( )

Give the last element focus within mozilla (i.e. SHIFT-TAB was pressed and focus should enter mozilla)

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com