nsIContextMenuListener2 in Firefox 3.6a1pre

 nsIContextMenuListener2

 This is an extended version of nsIContextMenuListener
 It provides a helper class, nsIContextMenuInfo, to allow access to
 background images as well as various utilities.

 @see nsIContextMenuListener
 @see nsIContextMenuInfo

 @status UNDER_REVIEW

[scriptable, uuid(7fb719b3-d804-4964-9596-77cf924ee314)]

Constants

 Flag. No context. */

const unsigned long CONTEXT_NONE = 0

 Flag. Context is a link element. */

const unsigned long CONTEXT_LINK = 1

 Flag. Context is an image element. */

const unsigned long CONTEXT_IMAGE = 2

 Flag. Context is the whole document. */

const unsigned long CONTEXT_DOCUMENT = 4

 Flag. Context is a text area element. */

const unsigned long CONTEXT_TEXT = 8

 Flag. Context is an input element. */

const unsigned long CONTEXT_INPUT = 16

 Flag. Context is a background image. */

const unsigned long CONTEXT_BACKGROUND_IMAGE = 32

Methods

 Called when the browser receives a context menu event (e.g. user is right-mouse
 clicking somewhere on the document). The combination of flags, along with the
 attributes of <CODE>aUtils</CODE>, indicate where and what was clicked on.

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

 aContextFlags                  aUtils.targetNode

 CONTEXT_LINK                   <A>
 CONTEXT_IMAGE                  <IMG>
 CONTEXT_IMAGE | CONTEXT_LINK   <IMG> with <A> as an ancestor
 CONTEXT_INPUT                  <INPUT>
 CONTEXT_INPUT | CONTEXT_IMAGE  <INPUT> with type=image
 CONTEXT_TEXT                   <TEXTAREA>
 CONTEXT_DOCUMENT               <HTML>
 CONTEXT_BACKGROUND_IMAGE       <HTML> with background image

 @param aContextFlags           Flags indicating the kind of context.
 @param aUtils                  Context information and helper utilities.

 @see nsIContextMenuInfo

void onShowContextMenu(in unsigned long aContextFlags, in nsIContextMenuInfo aUtils)