WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsIThreadInternal

IID:f89b5063-b06d-42f8-bf23-4dfcf2d80d6a
Inherits From:nsIThread

The XPCOM thread object implements this interface, which allows a consumer to observe dispatch activity on the thread.


Properties

nsIThreadObserver observer

Get/set the current thread observer (may be null). This attribute may be read from any thread, but must only be set on the thread corresponding to this thread object.


Methods

void popEventQueue ( ) void pushEventQueue ( nsIThreadEventFilter filter )

void popEventQueue ( )

Revert a call to PushEventQueue. When an event queue is popped, any events remaining in the queue are appended to the elder queue.


void pushEventQueue ( nsIThreadEventFilter filter )

This method causes any events currently enqueued on the thread to be suppressed until PopEventQueue is called. Additionally, any new events dispatched to the thread will only be processed if they are accepted by the given filter. If the filter is null, then new events are accepted. Calls to PushEventQueue may be nested and must each be paired with a call to PopEventQueue in order to restore the original state of the thread.

Arguments:
filter: The thread event filter to apply to dispatched events, or null to accept all dispatched events.

References

This interface is passed as an argument to the following methods:

nsIThreadObserver.afterProcessNextEvent, nsIThreadObserver.onDispatchedEvent, nsIThreadObserver.onProcessNextEvent

Reference documentation is generated from Mozilla's source.

Copyright © 1999-2006 XULPlanet.com