/usr/include/gtkmm-3.0/gtkmm/object.h is in libgtkmm-3.0-dev 3.22.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | /* Copyright (C) 1998-2010 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef _GTKMM_OBJECT_H
#define _GTKMM_OBJECT_H
#include <glibmm/object.h>
#include <gtkmm/base.h>
#include <gtkmmconfig.h>
namespace Gtk
{
class Object;
/** Mark a Gtk::Object as owned by its parent container widget, so you don't need to delete it manually.
* For instance,
* @code
* Gtk::Button* button = Gtk::manage( new Gtk::Button("Hello") );
* vbox.pack_start(*button); //vbox will delete button when vbox is deleted.
* @endcode
*
* @param obj A Gtk::Object, such as a gtkmm widget.
* @result The Gtk::Object passed as the @a obj parameter.
*/
template<class T>
T* manage(T* obj)
{
obj->set_manage();
return obj;
}
/** Gtk::Object is the base class for all widgets, and for a few non-widget objects such as
* Gtk::Adjustment. Gtk::Object predates Glib::Object; non-widgets that derive from Gtk::Object
* rather than Glib::Object do so for backward compatibility reasons.
*
* The most interesting difference between Gtk::Object and Glib::Object is the ability to use Gtk::manage() to delegate memory management to the container widget. Gtk::Objects can also be
* explicitly deleted at any time, instead of using only reference-counting, and container widgets
* can respond when their child objects are being deleted (for instance by removing the widget).
*/
class GTKMM_API Object : public Glib::Object
{
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef Object CppObjectType;
typedef Glib::Object_Class CppClassType;
typedef GObject BaseObjectType;
typedef GObjectClass BaseClassType;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
#ifdef GTKMM_DISABLE_DEPRECATED
/** This prevents use of Gtk::Object-derived classes with RefPtr.
* RefPtr should only be used with classes that have create() methods
* that return RefPtr.
*/
typedef int dont_allow_use_in_glib_refptr_;
#endif
Object(Object&& src) noexcept;
Object& operator=(Object&& src) noexcept;
~Object() noexcept override;
#ifndef DOXYGEN_SHOULD_SKIP_THIS
private:
friend class Object_Class;
static CppClassType object_class_;
// noncopyable
Object(const Object&);
Object& operator=(const Object&);
protected:
explicit Object(const Glib::ConstructParams& construct_params);
explicit Object(GObject* castitem);
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
static GType get_type() G_GNUC_CONST;
static GType get_base_type() G_GNUC_CONST;
#endif
///Provides access to the underlying C GtkObject.
GObject* gobj() { return reinterpret_cast<GObject*>(gobject_); }
///Provides access to the underlying C GtkObject.
const GObject* gobj() const { return reinterpret_cast<GObject*>(gobject_); }
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
/** Used by Gtk::manage(). You should not need to use this directly.
*/
void set_manage() override;
#endif //DOXYGEN_SHOULD_SKIP_THIS
#ifndef DOXYGEN_SHOULD_SKIP_THIS
/** Private API.
*/
bool is_managed_() const;
#endif //DOXYGEN_SHOULD_SKIP_THIS
protected:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
/** Private API.
*/
void destroy_();
#endif //DOXYGEN_SHOULD_SKIP_THIS
#ifndef DOXYGEN_SHOULD_SKIP_THIS
void _init_unmanage(bool is_toplevel = false);
void destroy_notify_() override;
void disconnect_cpp_wrapper();
void _release_c_instance();
static void callback_weak_notify_(void* data, GObject* gobject); //only connected for a short time.
// set if flags used by derived classes.
bool referenced_; // = not managed.
bool gobject_disposed_;
#endif //DOXYGEN_SHOULD_SKIP_THIS
};
} // namespace Gtk
#endif /* _GTKMM_OBJECT_H */
|