diff options
Diffstat (limited to 'glib/glibmm/objectbase.h')
-rw-r--r-- | glib/glibmm/objectbase.h | 124 |
1 files changed, 124 insertions, 0 deletions
diff --git a/glib/glibmm/objectbase.h b/glib/glibmm/objectbase.h new file mode 100644 index 00000000..edeb40c1 --- /dev/null +++ b/glib/glibmm/objectbase.h @@ -0,0 +1,124 @@ +// -*- c++ -*- +#ifndef _GLIBMM_OBJECTBASE_H +#define _GLIBMM_OBJECTBASE_H + +/* $Id$ */ + +/* Copyright 2002 The gtkmm Development Team + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free + * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +#include <sigc++/object.h> +#include <typeinfo> +#include <glibmmconfig.h> +#include <glibmm/debug.h> + +GTKMM_USING_STD(type_info) + +#ifndef DOXYGEN_SHOULD_SKIP_THIS +extern "C" { typedef struct _GObject GObject; } +#endif + + +namespace Glib +{ + +#ifndef DOXYGEN_SHOULD_SKIP_THIS +class GSigConnectionNode; +#endif + +class ObjectBase : public SigC::Object +{ +protected: + // Glib::ObjectBase is used as virtual base class. This means the ObjectBase + // ctor runs before all others -- either implicitly or explicitly. Each of + // the available ctors initializes custom_type_name_ in a different way: + // + // 1) default: custom_type_name_ = "gtkmm__anonymous_custom_type" + // 2) const char*: custom_type_name_ = custom_type_name + // 3) type_info: custom_type_name_ = custom_type_info.name() + // + // All classes generated by gtkmmproc use ctor 2) with custom_type_name = 0, + // which essentially means it's not a custom type. This is used to optimize + // vfunc and signal handler callbacks -- since the C++ virtual methods are + // not overridden, invocation can be skipped. + // + // The default ctor 1) is called implicitly from the ctor of user-derived + // classes -- yes, even if e.g. Gtk::Button calls ctor 2), a derived ctor + // always overrides this choice. The language itself ensures that the ctor + // is only invoked once. + // + // Ctor 3) is a special feature to allow creation of derived types on the + // fly, without having to use g_object_new() manually. This feature is + // sometimes necessary, e.g. to implement a custom Gtk::CellRenderer. The + // neat trick with the virtual base class ctor makes it possible to reuse + // the same direct base class' ctor as with non-custom types. + + ObjectBase(); + explicit ObjectBase(const char* custom_type_name); + explicit ObjectBase(const std::type_info& custom_type_info); + + virtual ~ObjectBase() = 0; + + // Called by Glib::Object and Glib::Interface constructors. See comments there. + void initialize(GObject* castitem); + +public: + virtual void reference() const; // overrides SigC::ObjectBase::reference() + virtual void unreference() const; // overrides SigC::ObjectBase::unreference() + + inline GObject* gobj() { return gobject_; } + inline const GObject* gobj() const { return gobject_; } + + // Give a ref-ed copy to someone. Use for direct struct access. + GObject* gobj_copy() const; + +#ifndef DOXYGEN_SHOULD_SKIP_THIS + static ObjectBase* _get_current_wrapper(GObject* object); +#endif + +protected: + GObject* gobject_; // the GLib/GDK/GTK+ object instance + const char* custom_type_name_; + bool cpp_destruction_in_progress_; + + bool is_anonymous_custom_() const; + bool is_derived_() const; + + static void destroy_notify_callback_(void* data); + virtual void destroy_notify_(); + + void _set_current_wrapper(GObject* object); + +private: + // noncopyable + ObjectBase(const ObjectBase&); + ObjectBase& operator=(const ObjectBase&); + + virtual void set_manage(); // calls g_error() + +#ifndef DOXYGEN_SHOULD_SKIP_THIS + friend class Glib::GSigConnectionNode; // for GSigConnectionNode::notify() +#endif +}; + +bool _gobject_cppinstance_already_deleted(GObject* gobject); + +} // namespace Glib + + +#endif /* _GLIBMM_OBJECTBASE_H */ + |