The nsIThreadInternal
interface is implemented by the XPCOM thread object to let consumers observe dispatch activity on a thread.
Please add a summary to this article.
Last changed in Gecko 1.9 (Firefox 3)
Inherits from: nsIThread
Method overview
void popEventQueue(); |
void pushEventQueue(in nsIThreadEventFilter filter); |
Attributes
Attribute | Type | Description |
observer |
| Get/set the current thread observer; set to null to disable observing. This attribute may be read from any thread but must only be set on the thread corresponding to this thread object. The observer will be released on the thread corresponding to this thread object after all other events have been processed during a call to Shutdown. |
Methods
popEventQueue()
Reverts a call to PushEventQueue()
. When an event queue is popped, any events remaining in the queue are appended to the elder queue.
void popEventQueue();
Parameters
None.
pushEventQueue()
Causes any events currently enqueued on the thread to be suppressed until PopEventQueue()
is called. In addition, any new events dispatched to the thread are only processed if they are accepted by the specified filter.
If the filter is null
, all new events are accepted.
Calls to pushEventQueue()
may be nested, and must each be paired with a corresponding call to PopEventQueue()
to restore the original state of the thread.
void pushEventQueue( in nsIThreadEventFilter filter );
Parameters
filter
- The
nsIThreadEventFilter
to apply to dispatched events, ornull
to accept all dispatched events.