GFC Logo GFC Title Logo
Reference Manual
Main Page  |  Namespace List  |  Alphabetical List  |  Class List  |  File List

GFC::G::ObjectSignals Class Reference

Abstract base class that implements the virtual signal handlers for G::Object. More...

#include <gfc/glib/objectsignals.hh>

Inheritance diagram for GFC::G::ObjectSignals:

GFC::G::TypeInstance GFC::Trackable List of all members.

Public Member Functions

Signal Handlers

Static Public Member Functions

Protected Member Functions

Constructors

Detailed Description

Abstract base class that implements the virtual signal handlers for G::Object.

In GFC a signal object is an abstract implementation class that implements the vitual signal handling mechanism for the corresponding instance object. Signal objects can only be used as a base class to multiplely inherit from. This way, the overhead associated with multiple virtual function calls and large virtual function tables is minimized by not forcing you to accept this overhead when your not overriding any virtual signal handlers.

The main reason to override an object's virtual signal handlers would be to customize an object's default response to one or more signals. You should note that in GFC each virtual signal handler is called before the corresponding default GTK+ signal handler. This gives you the powerful choice of either calling or not calling the default handler. Another reason to override an object's virtual signal handlers would be for convenience. When your deriving a new class from an exisiting object instead of connecting to object signals in your constructor using the object's proxy signal functions (ligsigc) you can override one or more of the object's virtual signal handlers by multiplely inheriting your new class from the object's signal class. For example, to create a main window and override the on_delete_event() signal handler you would do something like this:

    #include <gfc/gtk/window.hh>
    #include <gfc/gtk/windowsignals.hh>
   
    using namespace GFC;
   
    class MyWindow : public Gtk::Window, protected Gtk::WindowSignals
    {
        virtual bool on_delete_event(const Gdk::EventAny& event);
   
    public: 
        MyWindow();
    }; */


Constructor & Destructor Documentation

GFC::G::ObjectSignals::ObjectSignals Object object  )  [protected]
 

Constructs a new ObjectSignals object.

Parameters:
object A G::Object inheriting the G::ObjectSignals implementation.


Member Function Documentation

virtual void GFC::G::ObjectSignals::on_notify GParamSpec *  pspec  )  [virtual]
 

Called when a property on an object is changed.

Parameters:
pspec A GParamSpec object that holds the meta data specifying the new property.

GQuark GFC::G::ObjectSignals::quark  )  [static]
 

Returns a quark that indentifies an instance object's stored signal class pointer.

The pointer will be null if an object or widget doesn't multilplely inherit from its signal class.


The documentation for this class was generated from the following file:
Generated on Tue Aug 24 00:04:58 2004 for GFC-Core by doxygen 1.3.8