Name
gobject.MainContext — an object representing a set of event sources to be handled
in a gobject.MainLoop.
Description
A gobject.MainContext
represents a set of event sources that can be run in a single thread. File
descriptors (plain files, pipes or sockets) and timeouts are the standard
event sources for GTK and PyGTK though
others can be added. Each event source is assigned a priority. The default
priority, gobject.PRIORITY_DEFAULT, is 0. Values less
than 0 denote higher priorities. Values greater than 0 denote lower
priorities. Events from high priority sources are always processed before
events from lower priority sources. Single iterations of a gobject.MainContext
can be run with the iteration()
method.
Methods
gobject.MainContext.iteration
may_block : | if TRUE the call may block
waiting for an event. |
Returns : | TRUE if events were
dispatched. |
The iteration() method runs a single
iteration. This involves:
- checking to see if any associated event sources are ready
to be processed;
- then if no events sources are ready and
may_block is TRUE, waiting for a
source to become ready;
- and finally, dispatching the highest priority events
sources that are ready
Note that even when may_block is
TRUE, it is still possible for
iteration() to return FALSE,
since the the wait may be interrupted for other reasons than an event source
becoming ready.
gobject.MainContext.pending
Returns : | TRUE if events are
pending. |
The pending() method checks if any
associated sources have pending events.