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
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.
aContextFlag | aNode |
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> |
aContextFlags | Flags indicating the kind of context. |
aEvent | The DOM context menu event. |
aNode | The DOM node most relevant to the context. |
NS_OK always.
|
Flag. No context. */
Flag. Context is a link element. */
Flag. Context is an image element. */
Flag. Context is the whole document. */
Flag. Context is a text area element. */
Flag. Context is an input element. */