PRBool hasPendingEvents ( )

This method may be called to determine if there are any events ready to be processed. It may only be called when this thread is the current thread.

Because events may be added to this thread by another thread, a "false" result does not mean that this thread has no pending events. It only means that there were no pending events when this method was called.

PRBool processNextEvent ( PRBool mayWait )

Process the next event. If there are no pending events, then this method may wait -- depending on the value of the mayWait parameter -- until an event is dispatched to this thread. This method is re-entrant but may only be called if this thread is the current thread.

Arguments:

mayWait: A boolean parameter that if "true" indicates that the method may block the calling thread to wait for a pending event.

void shutdown ( )

Shutdown the thread. This method prevents further dispatch of events to the thread, and it causes any pending events to run to completion before the thread joins (see PR_JoinThread) with the current thread. During this method call, events for the current thread may be processed.

This method MAY NOT be executed from the thread itself. Instead, it is meant to be executed from another thread (usually the thread that created this thread or the main application thread). When this function returns, the thread will be shutdown, and it will no longer be possible to dispatch events to the thread.