void focus ( nsIDOMElement element )

Focus the element element. The element should be in the same document that the window is displaying. Pass null to blur the element, if any, that currently has focus, and focus the document.

Cannot be accessed from unprivileged context (not content-accessible) Will throw a DOM security error if called without UniversalXPConnect privileges.

Arguments:

element: the element to focus

void garbageCollect ( )

Force a garbage collection. This will run the cycle-collector twice to make sure all garbage is collected.

Will throw a DOM security error if called without UniversalXPConnect privileges in non-debug builds. Available to all callers in debug builds.

AString getDocumentMetadata ( AString name )

Function to get metadata associated with the window's current document

Will throw a DOM security error if called without UniversalXPConnect privileges.

Arguments:

name: the name of the metadata. This should be all lowercase.

Returns:

the value of the metadata, or the empty string if it's not set

void redraw ( )

Force an immediate redraw of this window.

void sendKeyEvent ( AString type , PRInt32 keyCode , PRInt32 charCode , PRInt32 modifiers )

Synthesize a key event to the window. The event types supported are: keydown, keyup, keypress

Key events generally end up being sent to the focused node.

Cannot be accessed from unprivileged context (not content-accessible) Will throw a DOM security error if called without UniversalXPConnect privileges.

Arguments:

type: event type

keyCode: key code

charCode: character code

modifiers: modifiers pressed, using constants defined in nsIDOMNSEvent

void sendMouseEvent ( AString type , PRInt32 aX , PRInt32 aY , PRInt32 button , PRInt32 clickCount , PRInt32 modifiers )

Synthesize a mouse event for a window. The event types supported are: mousedown, mouseup, mousemove, mouseover, mouseout, contextmenu

Events are sent in coordinates offset by aX and aY from the window.

Note that additional events may be fired as a result of this call. For instance, typically a click event will be fired as a result of a mousedown and mouseup in sequence.

Normally at this level of events, the mouseover and mouseout events are only fired when the window is entered or exited. For inter-element mouseover and mouseout events, a movemove event fired on the new element should be sufficient to generate the correct over and out events as well.

Cannot be accessed from unprivileged context (not content-accessible) Will throw a DOM security error if called without UniversalXPConnect privileges.

Arguments:

type: event type

aX: x offset

aY: y offset

button: button to synthesize

clickCount: number of clicks that have been performed

modifiers: modifiers pressed, using constants defined in nsIDOMNSEvent