nsIContextMenuListener

An optional interface for embedding clients wishing to receive
notifications for context menu events (e.g. generated by
a user right-mouse clicking on a link). The embedder implements
this interface on the web browser chrome object associated
with the window that notifications are required for. When a context
menu event, the browser will call this interface if present.

@see nsIDOMNode
@see nsIDOMEvent

Methods

onShowContextMenu(aContextFlags, aEvent, aNode)

Called when the browser receives a context menu event (e.g. user is right-mouse
clicking somewhere on the document). The combination of flags, event and node
provided in the call indicate where and what was clicked on.

The following table describes what context flags and node combinations are
possible.

aContextFlagaNode
CONTEXT_LINK<A>
CONTEXT_IMAGE<IMG>
CONTEXT_IMAGE | CONTEXT_LINK<IMG> with an <A> as an ancestor
CONTEXT_INPUT<INPUT>
CONTEXT_TEXT<TEXTAREA>
CONTEXT_DOCUMENT<HTML>

Parameters

aContextFlags Flags indicating the kind of context.
aEvent The DOM context menu event.
aNode The DOM node most relevant to the context.

Returns

NS_OK always.

Constants

CONTEXT_NONE

Flag. No context. */

Flag. Context is a link element. */

CONTEXT_IMAGE

Flag. Context is an image element. */

CONTEXT_DOCUMENT

Flag. Context is the whole document. */

CONTEXT_TEXT

Flag. Context is a text area element. */

CONTEXT_INPUT

Flag. Context is an input element. */