Glib::Source Class Reference
[The Main Event Loop]
Inheritance diagram for Glib::Source:
Public Types | |
| typedef Glib::Source | CppObjectType |
| typedef GSource | BaseObjectType |
Public Member Functions | |
| unsigned int | attach (const Glib::RefPtr<MainContext>& context) |
| Adds a Source to a context so that it will be executed within that context. | |
| unsigned int | attach () |
| Adds a Source to a context so that it will be executed within that context. | |
| void | destroy () |
| Removes a source from its MainContext, if any, and marks it as destroyed. | |
| void | set_priority (int priority) |
| Sets the priority of a source. | |
| int | get_priority () const |
| Gets the priority of a source. | |
| void | set_can_recurse (bool can_recurse) |
| Sets whether a source can be called recursively. | |
| bool | get_can_recurse () const |
| Checks whether a source is allowed to be called recursively. | |
| unsigned int | get_id () const |
| Returns the numeric ID for a particular source. | |
| Glib::RefPtr<MainContext> | get_context () |
| Gets the MainContext with which the source is associated. | |
| GSource* | gobj () |
| const GSource* | gobj () const |
| GSource* | gobj_copy () const |
| void | reference () const |
| void | unreference () const |
Static Public Member Functions | |
| static Glib::RefPtr<Source> | create () |
| static void | destroy_notify_callback (void* data) |
Protected Member Functions | |
| Source () | |
| Construct an object that uses the virtual functions prepare(), check() and dispatch(). | |
| Source (GSource* cast_item, GSourceFunc callback_func) | |
| Wrap an existing GSource object and install the given callback function. | |
| virtual | ~Source () |
| sigc::connection | connect_generic (const sigc::slot_base& slot) |
| void | add_poll (PollFD& poll_fd) |
| Adds a file descriptor to the set of file descriptors polled for this source. | |
| void | remove_poll (PollFD& poll_fd) |
| Removes a file descriptor from the set of file descriptors polled for this source. | |
| void | get_current_time (Glib::TimeVal& current_time) |
| Gets the "current time" to be used when checking this source. | |
| virtual bool | prepare (int& timeout)=0 |
| virtual bool | check ()=0 |
| virtual bool | dispatch (sigc::slot_base* slot)=0 |
Member Typedef Documentation
Reimplemented in Glib::TimeoutSource, Glib::IdleSource, and Glib::IOSource.
| typedef GSource Glib::Source::BaseObjectType |
Constructor & Destructor Documentation
| Glib::Source::Source | ( | ) | [protected] |
Construct an object that uses the virtual functions prepare(), check() and dispatch().
| Glib::Source::Source | ( | GSource * | cast_item, | |
| GSourceFunc | callback_func | |||
| ) | [protected] |
Wrap an existing GSource object and install the given callback function.
The constructed object doesn't use the virtual functions prepare(), check() and dispatch(). This constructor is for use by derived types that need to wrap a GSource object. The callback function can be a static member function. But beware - depending on the actual implementation of the GSource's virtual functions the expected type of the callback function can differ from GSourceFunc.
| virtual Glib::Source::~Source | ( | ) | [protected, virtual] |
Member Function Documentation
| static Glib::RefPtr<Source> Glib::Source::create | ( | ) | [static] |
Reimplemented in Glib::IdleSource.
| unsigned int Glib::Source::attach | ( | const Glib::RefPtr<MainContext>& | context | ) |
Adds a Source to a context so that it will be executed within that context.
- Parameters:
-
context A MainContext.
- Returns:
- The ID for the source within the MainContext.
| unsigned int Glib::Source::attach | ( | ) |
Adds a Source to a context so that it will be executed within that context.
The default context will be used.
- Returns:
- The ID for the source within the MainContext.
| void Glib::Source::destroy | ( | ) |
Removes a source from its MainContext, if any, and marks it as destroyed.
The source cannot be subsequently added to another context.
| void Glib::Source::set_priority | ( | int | priority | ) |
Sets the priority of a source.
While the main loop is being run, a source will be dispatched if it is ready to be dispatched and no sources at a higher (numerically smaller) priority are ready to be dispatched.
- Parameters:
-
priority The new priority.
| int Glib::Source::get_priority | ( | ) | const |
Gets the priority of a source.
- Returns:
- The priority of the source.
| void Glib::Source::set_can_recurse | ( | bool | can_recurse | ) |
Sets whether a source can be called recursively.
If can_recurse is true, then while the source is being dispatched then this source will be processed normally. Otherwise, all processing of this source is blocked until the dispatch function returns.
- Parameters:
-
can_recurse Whether recursion is allowed for this source.
| bool Glib::Source::get_can_recurse | ( | ) | const |
Checks whether a source is allowed to be called recursively.
see set_can_recurse().
- Returns:
- Whether recursion is allowed.
| unsigned int Glib::Source::get_id | ( | ) | const |
Returns the numeric ID for a particular source.
The ID of a source is unique within a particular main loop context. The reverse mapping from ID to source is done by MainContext::find_source_by_id().
- Returns:
- The ID for the source.
| Glib::RefPtr<MainContext> Glib::Source::get_context | ( | ) |
Gets the MainContext with which the source is associated.
Calling this function on a destroyed source is an error.
- Returns:
- The MainContext with which the source is associated, or a null RefPtr if the context has not yet been added to a source.
| GSource* Glib::Source::gobj | ( | ) | [inline] |
| const GSource* Glib::Source::gobj | ( | ) | const [inline] |
| GSource* Glib::Source::gobj_copy | ( | ) | const |
| void Glib::Source::reference | ( | ) | const |
| void Glib::Source::unreference | ( | ) | const |
| sigc::connection Glib::Source::connect_generic | ( | const sigc::slot_base & | slot | ) | [protected] |
| void Glib::Source::add_poll | ( | PollFD& | poll_fd | ) | [protected] |
Adds a file descriptor to the set of file descriptors polled for this source.
The event source's check function will typically test the revents field in the PollFD and return true if events need to be processed.
- Parameters:
-
poll_fd A PollFD object holding information about a file descriptor to watch.
| void Glib::Source::remove_poll | ( | PollFD& | poll_fd | ) | [protected] |
Removes a file descriptor from the set of file descriptors polled for this source.
- Parameters:
-
poll_fd A PollFD object previously passed to add_poll().
| void Glib::Source::get_current_time | ( | Glib::TimeVal& | current_time | ) | [protected] |
Gets the "current time" to be used when checking this source.
The advantage of calling this function over calling get_current_time() directly is that when checking multiple sources, GLib can cache a single value instead of having to repeatedly get the system time.
- Parameters:
-
current_time Glib::TimeVal in which to store current time
| virtual bool Glib::Source::prepare | ( | int & | timeout | ) | [protected, pure virtual] |
Implemented in Glib::TimeoutSource, Glib::IdleSource, and Glib::IOSource.
| virtual bool Glib::Source::check | ( | ) | [protected, pure virtual] |
Implemented in Glib::TimeoutSource, Glib::IdleSource, and Glib::IOSource.
| virtual bool Glib::Source::dispatch | ( | sigc::slot_base * | slot | ) | [protected, pure virtual] |
Implemented in Glib::TimeoutSource, Glib::IdleSource, and Glib::IOSource.
| static void Glib::Source::destroy_notify_callback | ( | void * | data | ) | [static] |
The documentation for this class was generated from the following file: