Struct xpcom::interfaces::nsIMessageBroadcaster [] [src]

#[repr(C)]
pub struct nsIMessageBroadcaster { /* fields omitted */ }

interface nsIMessageBroadcaster : nsIMessageListenerManager

/**
 * Message "broadcasters" don't have a single "other side" that they
 * send messages to, but rather a set of subordinate message managers.
 * For example, broadcasting a message through a window message
 * manager will broadcast the message to all frame message managers
 * within its window.
 */

Methods

impl nsIMessageBroadcaster
[src]

[src]

Cast this nsIMessageBroadcaster to one of its base interfaces.

impl nsIMessageBroadcaster
[src]

[src]

/**
   * Number of subordinate message managers.
   */

readonly attribute unsigned long childCount;

[src]

/**
   * Return a single subordinate message manager.
   */

nsIMessageListenerManager getChildAt (in unsigned long aIndex);

[src]

/**
   * Some processes are kept alive after their last tab/window are closed for testing
   * (see dom.ipc.keepProcessesAlive). This function releases those.
   */

void releaseCachedProcesses ();

Methods from Deref<Target = nsIMessageListenerManager>

[src]

Cast this nsIMessageListenerManager to one of its base interfaces.

[src]

/**
   * Register |listener| to receive |messageName|.  All listener
   * callbacks for a particular message are invoked when that message
   * is received.
   *
   * The message manager holds a strong ref to |listener|.
   *
   * If the same listener registers twice for the same message, the
   * second registration is ignored.
   *
   * Pass true for listenWhenClosed if you want to receive messages
   * during the short period after a frame has been removed from the
   * DOM and before its frame script has finished unloading. This
   * parameter only has an effect for frame message managers in
   * the main process. Default is false.
   */

void addMessageListener (in AString messageName, in nsIMessageListener listener, [optional] in boolean listenWhenClosed);

[src]

/**
   * Undo an |addMessageListener| call -- that is, calling this causes us to no
   * longer invoke |listener| when |messageName| is received.
   *
   * removeMessageListener does not remove a message listener added via
   * addWeakMessageListener; use removeWeakMessageListener for that.
   */

void removeMessageListener (in AString messageName, in nsIMessageListener listener);

[src]

/**
   * This is just like addMessageListener, except the message manager holds a
   * weak ref to |listener|.
   *
   * If you have two weak message listeners for the same message, they may be
   * called in any order.
   */

void addWeakMessageListener (in AString messageName, in nsIMessageListener listener);

[src]

/**
   * This undoes an |addWeakMessageListener| call.
   */

void removeWeakMessageListener (in AString messageName, in nsIMessageListener listener);

[src]

[notxpcom] boolean markForCC ();

Trait Implementations

impl XpCom for nsIMessageBroadcaster
[src]

IID: nsIID = nsID(1300062893, 18213, 20281, [134, 207, 143, 178, 43, 249, 193, 216])

[src]

Perform a QueryInterface call on this object, attempting to dynamically cast it to the requested interface type. Returns Some(RefPtr) if the cast succeeded, and None otherwise. Read more

impl RefCounted for nsIMessageBroadcaster
[src]

[src]

Increment the reference count.

[src]

Decrement the reference count, potentially freeing backing memory.

impl Deref for nsIMessageBroadcaster
[src]

The resulting type after dereferencing.

[src]

Dereferences the value.