← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkObject.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkObject.html
53
53
#define             <a class="link" href="GtkObject.html#GTK-OBJECT-FLAGS:CAPS" title="GTK_OBJECT_FLAGS()">GTK_OBJECT_FLAGS</a>                    (obj)
54
54
#define             <a class="link" href="GtkObject.html#GTK-OBJECT-FLOATING:CAPS" title="GTK_OBJECT_FLOATING()">GTK_OBJECT_FLOATING</a>                 (obj)
55
55
enum                <a class="link" href="GtkObject.html#GtkArgFlags" title="enum GtkArgFlags">GtkArgFlags</a>;
56
 
<a class="link" href="GtkObject.html" title="GtkObject"><span class="returnvalue">GtkObject</span></a>*          <a class="link" href="GtkObject.html#gtk-object-new" title="gtk_object_new ()">gtk_object_new</a>                      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
57
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
56
<a class="link" href="GtkObject.html" title="GtkObject"><span class="returnvalue">GtkObject</span></a>*          <a class="link" href="GtkObject.html#gtk-object-new" title="gtk_object_new ()">gtk_object_new</a>                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
 
57
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
58
58
                                                         <em class="parameter"><code>...</code></em>);
59
59
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-sink" title="gtk_object_sink ()">gtk_object_sink</a>                     (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);
60
60
<a class="link" href="GtkObject.html" title="GtkObject"><span class="returnvalue">GtkObject</span></a>*          <a class="link" href="GtkObject.html#gtk-object-ref" title="gtk_object_ref ()">gtk_object_ref</a>                      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-unref" title="gtk_object_unref ()">gtk_object_unref</a>                    (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);
62
62
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-weakref" title="gtk_object_weakref ()">gtk_object_weakref</a>                  (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
63
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
64
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
63
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
65
65
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-weakunref" title="gtk_object_weakunref ()">gtk_object_weakunref</a>                (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
66
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
67
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
66
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
 
67
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
68
68
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-destroy" title="gtk_object_destroy ()">gtk_object_destroy</a>                  (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);
69
69
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-get" title="gtk_object_get ()">gtk_object_get</a>                      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
70
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
70
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
71
71
                                                         <em class="parameter"><code>...</code></em>);
72
72
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-set" title="gtk_object_set ()">gtk_object_set</a>                      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
73
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
73
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
74
74
                                                         <em class="parameter"><code>...</code></em>);
75
75
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-set-data" title="gtk_object_set_data ()">gtk_object_set_data</a>                 (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
76
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
77
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
76
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
 
77
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
78
78
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-set-data-full" title="gtk_object_set_data_full ()">gtk_object_set_data_full</a>            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
79
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
80
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
81
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
 
79
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
 
80
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
81
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
82
82
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-remove-data" title="gtk_object_remove_data ()">gtk_object_remove_data</a>              (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
83
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
84
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()">gtk_object_get_data</a>                 (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
85
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
 
83
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
 
84
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()">gtk_object_get_data</a>                 (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
 
85
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
86
86
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-remove-no-notify" title="gtk_object_remove_no_notify ()">gtk_object_remove_no_notify</a>         (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
87
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
 
87
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
88
88
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-set-user-data" title="gtk_object_set_user_data ()">gtk_object_set_user_data</a>            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
89
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
90
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="GtkObject.html#gtk-object-get-user-data" title="gtk_object_get_user_data ()">gtk_object_get_user_data</a>            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);
91
 
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-add-arg-type" title="gtk_object_add_arg_type ()">gtk_object_add_arg_type</a>             (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_name</code></em>,
92
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> arg_type</code></em>,
93
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_flags</code></em>,
94
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_id</code></em>);
 
89
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
90
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="GtkObject.html#gtk-object-get-user-data" title="gtk_object_get_user_data ()">gtk_object_get_user_data</a>            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);
 
91
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-add-arg-type" title="gtk_object_add_arg_type ()">gtk_object_add_arg_type</a>             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_name</code></em>,
 
92
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> arg_type</code></em>,
 
93
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_flags</code></em>,
 
94
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_id</code></em>);
95
95
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-set-data-by-id" title="gtk_object_set_data_by_id ()">gtk_object_set_data_by_id</a>           (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
96
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
97
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
96
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
 
97
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
98
98
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-set-data-by-id-full" title="gtk_object_set_data_by_id_full ()">gtk_object_set_data_by_id_full</a>      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
99
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
100
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
101
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
102
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="GtkObject.html#gtk-object-get-data-by-id" title="gtk_object_get_data_by_id ()">gtk_object_get_data_by_id</a>           (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
103
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);
 
99
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
 
100
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
101
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
 
102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="GtkObject.html#gtk-object-get-data-by-id" title="gtk_object_get_data_by_id ()">gtk_object_get_data_by_id</a>           (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
 
103
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);
104
104
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-remove-data-by-id" title="gtk_object_remove_data_by_id ()">gtk_object_remove_data_by_id</a>        (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
105
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);
 
105
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);
106
106
<span class="returnvalue">void</span>                <a class="link" href="GtkObject.html#gtk-object-remove-no-notify-by-id" title="gtk_object_remove_no_notify_by_id ()">gtk_object_remove_no_notify_by_id</a>   (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
107
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> key_id</code></em>);
 
107
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> key_id</code></em>);
108
108
#define             <a class="link" href="GtkObject.html#gtk-object-data-try-key" title="gtk_object_data_try_key">gtk_object_data_try_key</a>
109
109
#define             <a class="link" href="GtkObject.html#gtk-object-data-force-id" title="gtk_object_data_force_id">gtk_object_data_force_id</a>
110
110
</pre>
112
112
<div class="refsect1" title="Object Hierarchy">
113
113
<a name="GtkObject.object-hierarchy"></a><h2>Object Hierarchy</h2>
114
114
<pre class="synopsis">
115
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
116
 
   +----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
115
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
116
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
117
117
         +----GtkObject
118
118
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
119
119
               +----<a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>
128
128
<div class="refsect1" title="Properties">
129
129
<a name="GtkObject.properties"></a><h2>Properties</h2>
130
130
<pre class="synopsis">
131
 
  "<a class="link" href="GtkObject.html#GtkObject--user-data" title='The "user-data" property'>user-data</a>"                <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write
 
131
  "<a class="link" href="GtkObject.html#GtkObject--user-data" title='The "user-data" property'>user-data</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write
132
132
</pre>
133
133
</div>
134
134
<div class="refsect1" title="Signals">
140
140
<div class="refsect1" title="Description">
141
141
<a name="GtkObject.description"></a><h2>Description</h2>
142
142
<div class="refsect2" title="Description">
143
 
<a name="id1313757"></a><h3>Description</h3>
 
143
<a name="id1189966"></a><h3>Description</h3>
144
144
<p>
145
145
<a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> is the base class for all widgets, and for a few
146
146
non-widget objects such as <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>. <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> predates
147
 
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>; non-widgets that derive from <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> rather than
148
 
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> do so for backward compatibility reasons.
 
147
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>; non-widgets that derive from <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> rather than
 
148
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> do so for backward compatibility reasons.
149
149
</p>
150
150
<p>
151
151
<a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a>s are created with a "floating" reference count.
152
152
This means that the initial reference is not owned by anyone. Calling
153
 
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on a newly-created <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> is incorrect, the floating
 
153
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on a newly-created <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> is incorrect, the floating
154
154
reference has to be removed first. This can be done by anyone at any time,
155
 
by calling <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref-sink"><code class="function">g_object_ref_sink()</code></a> to convert the floating reference into a
156
 
regular reference. <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref-sink"><code class="function">g_object_ref_sink()</code></a> returns a new reference if an object
 
155
by calling <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref-sink"><code class="function">g_object_ref_sink()</code></a> to convert the floating reference into a
 
156
regular reference. <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref-sink"><code class="function">g_object_ref_sink()</code></a> returns a new reference if an object
157
157
is already sunk (has no floating reference).
158
158
</p>
159
159
<p>
165
165
    <tbody>
166
166
      <tr>
167
167
        <td class="listing_lines" align="right"><pre>1</pre></td>
168
 
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref-sink">g_object_ref_sink</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child_widget</span><span class="symbol">));</span></pre></td>
 
168
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref-sink">g_object_ref_sink</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child_widget</span><span class="symbol">));</span></pre></td>
169
169
      </tr>
170
170
    </tbody>
171
171
  </table>
222
222
</p>
223
223
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
224
224
<li class="listitem"><p>
225
 
Never call <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> unless you have previously called <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>,
 
225
Never call <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> unless you have previously called <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>,
226
226
even if you created the <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a>. (Note: this is <span class="emphasis"><em>not</em></span>
227
 
true for <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>; for <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>, the creator of the object owns a reference.)
 
227
true for <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>; for <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>, the creator of the object owns a reference.)
228
228
</p></li>
229
229
<li class="listitem"><p>
230
230
Call <a class="link" href="GtkObject.html#gtk-object-destroy" title="gtk_object_destroy ()"><code class="function">gtk_object_destroy()</code></a> to get rid of most objects in most cases.
232
232
</p></li>
233
233
<li class="listitem"><p> Because of the floating reference count, you don't need to
234
234
worry about reference counting for widgets and toplevel windows, unless you
235
 
explicitly call <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> yourself.</p></li>
 
235
explicitly call <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> yourself.</p></li>
236
236
</ul></div>
237
237
<p>
238
238
</p>
255
255
</pre>
256
256
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
257
257
<h3 class="title">Warning</h3>
258
 
<p><code class="literal">GTK_OBJECT_TYPE</code> has been deprecated since version 2.20 and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#G-OBJECT-TYPE:CAPS"><code class="function">G_OBJECT_TYPE()</code></a> instead.</p>
 
258
<p><code class="literal">GTK_OBJECT_TYPE</code> has been deprecated since version 2.20 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT-TYPE:CAPS"><code class="function">G_OBJECT_TYPE()</code></a> instead.</p>
259
259
</div>
260
260
<p>
261
261
Gets the type of an object.
276
276
</pre>
277
277
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
278
278
<h3 class="title">Warning</h3>
279
 
<p><code class="literal">GTK_OBJECT_TYPE_NAME</code> has been deprecated since version 2.20 and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#G-OBJECT-TYPE-NAME:CAPS"><code class="function">G_OBJECT_TYPE_NAME()</code></a> instead.</p>
 
279
<p><code class="literal">GTK_OBJECT_TYPE_NAME</code> has been deprecated since version 2.20 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT-TYPE-NAME:CAPS"><code class="function">G_OBJECT_TYPE_NAME()</code></a> instead.</p>
280
280
</div>
281
281
<p>
282
282
Gets the name of an object's type.
361
361
<p><code class="literal">GTK_OBJECT_FLOATING</code> is deprecated and should not be used in newly-written code.</p>
362
362
</div>
363
363
<p>
364
 
Evaluates to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the object still has its floating reference count.
 
364
Evaluates to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the object still has its floating reference count.
365
365
See the overview documentation for <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a>.
366
366
</p>
367
367
<div class="variablelist"><table border="0">
387
387
</pre>
388
388
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
389
389
<h3 class="title">Warning</h3>
390
 
<p><code class="literal">GtkArgFlags</code> is deprecated and should not be used in newly-written code. Use corresponding <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> features instead</p>
 
390
<p><code class="literal">GtkArgFlags</code> is deprecated and should not be used in newly-written code. Use corresponding <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> features instead</p>
391
391
</div>
392
392
<p>
393
393
Possible flags indicating how an argument should be treated.
430
430
<hr>
431
431
<div class="refsect2" title="gtk_object_new ()">
432
432
<a name="gtk-object-new"></a><h3>gtk_object_new ()</h3>
433
 
<pre class="programlisting"><a class="link" href="GtkObject.html" title="GtkObject"><span class="returnvalue">GtkObject</span></a>*          gtk_object_new                      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
434
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
433
<pre class="programlisting"><a class="link" href="GtkObject.html" title="GtkObject"><span class="returnvalue">GtkObject</span></a>*          gtk_object_new                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
 
434
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
435
435
                                                         <em class="parameter"><code>...</code></em>);</pre>
436
436
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
437
437
<h3 class="title">Warning</h3>
438
 
<p><code class="literal">gtk_object_new</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a> instead.</p>
 
438
<p><code class="literal">gtk_object_new</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a> instead.</p>
439
439
</div>
440
440
<p>
441
441
Constructs an object given its arguments, enumerated in the call to the
460
460
<tr>
461
461
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
462
462
<td>the first argument's value, followed by any number of
463
 
name/argument-value pairs, terminated with <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
463
name/argument-value pairs, terminated with <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
464
464
</td>
465
465
</tr>
466
466
<tr>
477
477
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_sink                     (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);</pre>
478
478
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
479
479
<h3 class="title">Warning</h3>
480
 
<p><code class="literal">gtk_object_sink</code> has been deprecated since version 2.10 and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref-sink"><code class="function">g_object_ref_sink()</code></a> instead</p>
 
480
<p><code class="literal">gtk_object_sink</code> has been deprecated since version 2.10 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref-sink"><code class="function">g_object_ref_sink()</code></a> instead</p>
481
481
</div>
482
482
<p>
483
483
Removes the floating reference from a <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a>, if it exists;
499
499
<pre class="programlisting"><a class="link" href="GtkObject.html" title="GtkObject"><span class="returnvalue">GtkObject</span></a>*          gtk_object_ref                      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);</pre>
500
500
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
501
501
<h3 class="title">Warning</h3>
502
 
<p><code class="literal">gtk_object_ref</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> instead.</p>
 
502
<p><code class="literal">gtk_object_ref</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> instead.</p>
503
503
</div>
504
504
<p>
505
505
Increases the reference count of the object.
527
527
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_unref                    (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);</pre>
528
528
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
529
529
<h3 class="title">Warning</h3>
530
 
<p><code class="literal">gtk_object_unref</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> instead.</p>
 
530
<p><code class="literal">gtk_object_unref</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> instead.</p>
531
531
</div>
532
532
<p>
533
533
Decreases the reference count of an object.  When its reference count drops
546
546
<div class="refsect2" title="gtk_object_weakref ()">
547
547
<a name="gtk-object-weakref"></a><h3>gtk_object_weakref ()</h3>
548
548
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_weakref                  (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
549
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
550
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
549
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
 
550
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
551
551
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
552
552
<h3 class="title">Warning</h3>
553
 
<p><code class="literal">gtk_object_weakref</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-weak-ref"><code class="function">g_object_weak_ref()</code></a> instead.</p>
 
553
<p><code class="literal">gtk_object_weakref</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-weak-ref"><code class="function">g_object_weak_ref()</code></a> instead.</p>
554
554
</div>
555
555
<p>
556
556
Adds a weak reference callback to an object. Weak references are used for notification when an object is
557
557
finalized. They are called "weak references" because they allow you to safely
558
 
hold a pointer to an object without calling <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> (<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> adds
 
558
hold a pointer to an object without calling <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> adds
559
559
a strong reference, that is, forces the object to stay alive).
560
560
</p>
561
561
<div class="variablelist"><table border="0">
583
583
<div class="refsect2" title="gtk_object_weakunref ()">
584
584
<a name="gtk-object-weakunref"></a><h3>gtk_object_weakunref ()</h3>
585
585
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_weakunref                (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
586
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
587
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
586
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>,
 
587
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
588
588
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
589
589
<h3 class="title">Warning</h3>
590
 
<p><code class="literal">gtk_object_weakunref</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-weak-unref"><code class="function">g_object_weak_unref()</code></a> instead.</p>
 
590
<p><code class="literal">gtk_object_weakunref</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-weak-unref"><code class="function">g_object_weak_unref()</code></a> instead.</p>
591
591
</div>
592
592
<p>
593
593
Removes a weak reference callback to an object.
640
640
<div class="refsect2" title="gtk_object_get ()">
641
641
<a name="gtk-object-get"></a><h3>gtk_object_get ()</h3>
642
642
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_get                      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
643
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
643
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
644
644
                                                         <em class="parameter"><code>...</code></em>);</pre>
645
645
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
646
646
<h3 class="title">Warning</h3>
647
 
<p><code class="literal">gtk_object_get</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-get"><code class="function">g_object_get()</code></a> instead.</p>
 
647
<p><code class="literal">gtk_object_get</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-get"><code class="function">g_object_get()</code></a> instead.</p>
648
648
</div>
649
649
<p>
650
650
Gets properties of an object.
665
665
<tr>
666
666
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
667
667
<td>
668
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of name-return location pairs.
 
668
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of name-return location pairs.
669
669
</td>
670
670
</tr>
671
671
</tbody>
675
675
<div class="refsect2" title="gtk_object_set ()">
676
676
<a name="gtk-object-set"></a><h3>gtk_object_set ()</h3>
677
677
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_set                      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
678
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
678
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
679
679
                                                         <em class="parameter"><code>...</code></em>);</pre>
680
680
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
681
681
<h3 class="title">Warning</h3>
682
 
<p><code class="literal">gtk_object_set</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set"><code class="function">g_object_set()</code></a> instead.</p>
 
682
<p><code class="literal">gtk_object_set</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set"><code class="function">g_object_set()</code></a> instead.</p>
683
683
</div>
684
684
<p>
685
685
Sets properties on an object.
698
698
6</pre></td>
699
699
        <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal"> </span><span class="function">set_box_properties</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkBox.html">GtkBox</a></span><span class="symbol">*</span><span class="normal"> box</span><span class="symbol">)</span>
700
700
<span class="cbracket">{</span>
701
 
<span class="normal">  </span><span class="function"><a href="GtkObject.html#gtk-object-set">gtk_object_set</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_OBJECT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">box</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"homogeneous"</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">,</span>
 
701
<span class="normal">  </span><span class="function"><a href="GtkObject.html#gtk-object-set">gtk_object_set</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_OBJECT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">box</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"homogeneous"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">,</span>
702
702
<span class="normal">                                    </span><span class="string">"spacing"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">8</span><span class="symbol">,</span>
703
 
<span class="normal">                               <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
703
<span class="normal">                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
704
704
<span class="cbracket">}</span></pre></td>
705
705
      </tr>
706
706
    </tbody>
725
725
<tr>
726
726
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
727
727
<td>the value of the first argument, followed optionally
728
 
by more name/value pairs, followed by <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
728
by more name/value pairs, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
729
729
</td>
730
730
</tr>
731
731
</tbody>
735
735
<div class="refsect2" title="gtk_object_set_data ()">
736
736
<a name="gtk-object-set-data"></a><h3>gtk_object_set_data ()</h3>
737
737
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_set_data                 (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
738
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
739
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
738
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
 
739
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
740
740
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
741
741
<h3 class="title">Warning</h3>
742
 
<p><code class="literal">gtk_object_set_data</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> instead.</p>
 
742
<p><code class="literal">gtk_object_set_data</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> instead.</p>
743
743
</div>
744
744
<p>
745
745
Each object carries around a table of associations from
774
774
<div class="refsect2" title="gtk_object_set_data_full ()">
775
775
<a name="gtk-object-set-data-full"></a><h3>gtk_object_set_data_full ()</h3>
776
776
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_set_data_full            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
777
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
778
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
779
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
 
777
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
 
778
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
779
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
780
780
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
781
781
<h3 class="title">Warning</h3>
782
 
<p><code class="literal">gtk_object_set_data_full</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set-data-full"><code class="function">g_object_set_data_full()</code></a> instead.</p>
 
782
<p><code class="literal">gtk_object_set_data_full</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-data-full"><code class="function">g_object_set_data_full()</code></a> instead.</p>
783
783
</div>
784
784
<p>
785
785
Like <a class="link" href="GtkObject.html#gtk-object-set-data" title="gtk_object_set_data ()"><code class="function">gtk_object_set_data()</code></a> except it adds notification
816
816
<div class="refsect2" title="gtk_object_remove_data ()">
817
817
<a name="gtk-object-remove-data"></a><h3>gtk_object_remove_data ()</h3>
818
818
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_remove_data              (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
819
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
 
819
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
820
820
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
821
821
<h3 class="title">Warning</h3>
822
 
<p><code class="literal">gtk_object_remove_data</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> to set the object data to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.</p>
 
822
<p><code class="literal">gtk_object_remove_data</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> to set the object data to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.</p>
823
823
</div>
824
824
<p>
825
825
Removes a specified datum from the object's data associations (the object_data).
826
 
Subsequent calls to <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()"><code class="function">gtk_object_get_data()</code></a> will return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
826
Subsequent calls to <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()"><code class="function">gtk_object_get_data()</code></a> will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
827
827
</p>
828
828
<p>
829
829
If you specified a destroy handler with <a class="link" href="GtkObject.html#gtk-object-set-data-full" title="gtk_object_set_data_full ()"><code class="function">gtk_object_set_data_full()</code></a>,
848
848
<hr>
849
849
<div class="refsect2" title="gtk_object_get_data ()">
850
850
<a name="gtk-object-get-data"></a><h3>gtk_object_get_data ()</h3>
851
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            gtk_object_get_data                 (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
852
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
 
851
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            gtk_object_get_data                 (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
 
852
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
853
853
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
854
854
<h3 class="title">Warning</h3>
855
 
<p><code class="literal">gtk_object_get_data</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-get-data"><code class="function">g_object_get_data()</code></a> instead.</p>
 
855
<p><code class="literal">gtk_object_get_data</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-get-data"><code class="function">g_object_get_data()</code></a> instead.</p>
856
856
</div>
857
857
<p>
858
858
Get a named field from the object's table of associations (the object_data).
872
872
</tr>
873
873
<tr>
874
874
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
875
 
<td>the data if found, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.
 
875
<td>the data if found, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.
876
876
</td>
877
877
</tr>
878
878
</tbody>
882
882
<div class="refsect2" title="gtk_object_remove_no_notify ()">
883
883
<a name="gtk-object-remove-no-notify"></a><h3>gtk_object_remove_no_notify ()</h3>
884
884
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_remove_no_notify         (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
885
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
 
885
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
886
886
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
887
887
<h3 class="title">Warning</h3>
888
 
<p><code class="literal">gtk_object_remove_no_notify</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-steal-data"><code class="function">g_object_steal_data()</code></a> instead.</p>
 
888
<p><code class="literal">gtk_object_remove_no_notify</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-steal-data"><code class="function">g_object_steal_data()</code></a> instead.</p>
889
889
</div>
890
890
<p>
891
891
Remove a specified datum from the object's data associations (the object_data),
916
916
<div class="refsect2" title="gtk_object_set_user_data ()">
917
917
<a name="gtk-object-set-user-data"></a><h3>gtk_object_set_user_data ()</h3>
918
918
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_set_user_data            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
919
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
919
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
920
920
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
921
921
<h3 class="title">Warning</h3>
922
 
<p><code class="literal">gtk_object_set_user_data</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> instead.</p>
 
922
<p><code class="literal">gtk_object_set_user_data</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> instead.</p>
923
923
</div>
924
924
<p>
925
925
For convenience, every object offers a generic user data
944
944
<hr>
945
945
<div class="refsect2" title="gtk_object_get_user_data ()">
946
946
<a name="gtk-object-get-user-data"></a><h3>gtk_object_get_user_data ()</h3>
947
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            gtk_object_get_user_data            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);</pre>
 
947
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            gtk_object_get_user_data            (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);</pre>
948
948
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
949
949
<h3 class="title">Warning</h3>
950
 
<p><code class="literal">gtk_object_get_user_data</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-get-data"><code class="function">g_object_get_data()</code></a> instead.</p>
 
950
<p><code class="literal">gtk_object_get_user_data</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-get-data"><code class="function">g_object_get_data()</code></a> instead.</p>
951
951
</div>
952
952
<p>
953
953
Get the object's user data pointer.
975
975
<hr>
976
976
<div class="refsect2" title="gtk_object_add_arg_type ()">
977
977
<a name="gtk-object-add-arg-type"></a><h3>gtk_object_add_arg_type ()</h3>
978
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_add_arg_type             (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_name</code></em>,
979
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> arg_type</code></em>,
980
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_flags</code></em>,
981
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_id</code></em>);</pre>
 
978
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_add_arg_type             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_name</code></em>,
 
979
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> arg_type</code></em>,
 
980
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_flags</code></em>,
 
981
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_id</code></em>);</pre>
982
982
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
983
983
<h3 class="title">Warning</h3>
984
984
<p><code class="literal">gtk_object_add_arg_type</code> is deprecated and should not be used in newly-written code.</p>
985
985
</div>
986
986
<p>
987
 
Deprecated in favor of the <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property system including <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>.
 
987
Deprecated in favor of the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property system including <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>.
988
988
Add a new type of argument to an object class.
989
989
Usually this is called when registering a new type of object.
990
990
</p>
1020
1020
<div class="refsect2" title="gtk_object_set_data_by_id ()">
1021
1021
<a name="gtk-object-set-data-by-id"></a><h3>gtk_object_set_data_by_id ()</h3>
1022
1022
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_set_data_by_id           (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
1023
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
1024
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
1023
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
 
1024
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1025
1025
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1026
1026
<h3 class="title">Warning</h3>
1027
 
<p><code class="literal">gtk_object_set_data_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set-qdata"><code class="function">g_object_set_qdata()</code></a> instead.</p>
 
1027
<p><code class="literal">gtk_object_set_data_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-qdata"><code class="function">g_object_set_qdata()</code></a> instead.</p>
1028
1028
</div>
1029
1029
<p>
1030
1030
Just like <a class="link" href="GtkObject.html#gtk-object-set-data" title="gtk_object_set_data ()"><code class="function">gtk_object_set_data()</code></a> except that it takes
1031
 
a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
 
1031
a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
1032
1032
</p>
1033
1033
<p>
1034
1034
Use <a class="link" href="GtkObject.html#gtk-object-data-try-key" title="gtk_object_data_try_key"><code class="function">gtk_object_data_try_key()</code></a> and <a class="link" href="GtkObject.html#gtk-object-data-force-id" title="gtk_object_data_force_id"><code class="function">gtk_object_data_force_id()</code></a>
1059
1059
<div class="refsect2" title="gtk_object_set_data_by_id_full ()">
1060
1060
<a name="gtk-object-set-data-by-id-full"></a><h3>gtk_object_set_data_by_id_full ()</h3>
1061
1061
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_set_data_by_id_full      (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
1062
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
1063
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
1064
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
 
1062
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>,
 
1063
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
1064
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
1065
1065
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1066
1066
<h3 class="title">Warning</h3>
1067
 
<p><code class="literal">gtk_object_set_data_by_id_full</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set-qdata-full"><code class="function">g_object_set_qdata_full()</code></a> instead.</p>
 
1067
<p><code class="literal">gtk_object_set_data_by_id_full</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-qdata-full"><code class="function">g_object_set_qdata_full()</code></a> instead.</p>
1068
1068
</div>
1069
1069
<p>
1070
1070
Just like <a class="link" href="GtkObject.html#gtk-object-set-data-full" title="gtk_object_set_data_full ()"><code class="function">gtk_object_set_data_full()</code></a> except that it takes
1071
 
a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
 
1071
a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
1072
1072
</p>
1073
1073
<p>
1074
1074
Use <a class="link" href="GtkObject.html#gtk-object-data-try-key" title="gtk_object_data_try_key"><code class="function">gtk_object_data_try_key()</code></a> and <a class="link" href="GtkObject.html#gtk-object-data-force-id" title="gtk_object_data_force_id"><code class="function">gtk_object_data_force_id()</code></a>
1103
1103
<hr>
1104
1104
<div class="refsect2" title="gtk_object_get_data_by_id ()">
1105
1105
<a name="gtk-object-get-data-by-id"></a><h3>gtk_object_get_data_by_id ()</h3>
1106
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            gtk_object_get_data_by_id           (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
1107
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);</pre>
 
1106
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            gtk_object_get_data_by_id           (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
 
1107
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);</pre>
1108
1108
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1109
1109
<h3 class="title">Warning</h3>
1110
 
<p><code class="literal">gtk_object_get_data_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-get-qdata"><code class="function">g_object_get_qdata()</code></a> instead.</p>
 
1110
<p><code class="literal">gtk_object_get_data_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-get-qdata"><code class="function">g_object_get_qdata()</code></a> instead.</p>
1111
1111
</div>
1112
1112
<p>
1113
1113
Just like <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()"><code class="function">gtk_object_get_data()</code></a> except that it takes
1114
 
a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
 
1114
a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
1115
1115
</p>
1116
1116
<p>
1117
1117
Use <a class="link" href="GtkObject.html#gtk-object-data-try-key" title="gtk_object_data_try_key"><code class="function">gtk_object_data_try_key()</code></a> and <a class="link" href="GtkObject.html#gtk-object-data-force-id" title="gtk_object_data_force_id"><code class="function">gtk_object_data_force_id()</code></a>
1132
1132
</tr>
1133
1133
<tr>
1134
1134
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1135
 
<td>the data if found, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.
 
1135
<td>the data if found, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.
1136
1136
</td>
1137
1137
</tr>
1138
1138
</tbody>
1142
1142
<div class="refsect2" title="gtk_object_remove_data_by_id ()">
1143
1143
<a name="gtk-object-remove-data-by-id"></a><h3>gtk_object_remove_data_by_id ()</h3>
1144
1144
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_remove_data_by_id        (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
1145
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);</pre>
 
1145
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> data_id</code></em>);</pre>
1146
1146
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1147
1147
<h3 class="title">Warning</h3>
1148
 
<p><code class="literal">gtk_object_remove_data_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set-qdata"><code class="function">g_object_set_qdata()</code></a> with data of <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.</p>
 
1148
<p><code class="literal">gtk_object_remove_data_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-qdata"><code class="function">g_object_set_qdata()</code></a> with data of <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.</p>
1149
1149
</div>
1150
1150
<p>
1151
1151
Just like <a class="link" href="GtkObject.html#gtk-object-remove-data" title="gtk_object_remove_data ()"><code class="function">gtk_object_remove_data()</code></a> except that it takes
1152
 
a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
 
1152
a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
1153
1153
</p>
1154
1154
<p>
1155
1155
Remove a specified datum from the object's data associations.
1156
 
Subsequent calls to <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()"><code class="function">gtk_object_get_data()</code></a> will return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
1156
Subsequent calls to <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()"><code class="function">gtk_object_get_data()</code></a> will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1157
1157
</p>
1158
1158
<p>
1159
1159
Use <a class="link" href="GtkObject.html#gtk-object-data-try-key" title="gtk_object_data_try_key"><code class="function">gtk_object_data_try_key()</code></a> and <a class="link" href="GtkObject.html#gtk-object-data-force-id" title="gtk_object_data_force_id"><code class="function">gtk_object_data_force_id()</code></a>
1179
1179
<div class="refsect2" title="gtk_object_remove_no_notify_by_id ()">
1180
1180
<a name="gtk-object-remove-no-notify-by-id"></a><h3>gtk_object_remove_no_notify_by_id ()</h3>
1181
1181
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_object_remove_no_notify_by_id   (<em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>,
1182
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> key_id</code></em>);</pre>
 
1182
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> key_id</code></em>);</pre>
1183
1183
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1184
1184
<h3 class="title">Warning</h3>
1185
 
<p><code class="literal">gtk_object_remove_no_notify_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-steal-qdata"><code class="function">g_object_steal_qdata()</code></a> instead.</p>
 
1185
<p><code class="literal">gtk_object_remove_no_notify_by_id</code> is deprecated and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-steal-qdata"><code class="function">g_object_steal_qdata()</code></a> instead.</p>
1186
1186
</div>
1187
1187
<p>
1188
1188
Just like <a class="link" href="GtkObject.html#gtk-object-remove-no-notify" title="gtk_object_remove_no_notify ()"><code class="function">gtk_object_remove_no_notify()</code></a> except that it takes
1189
 
a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
 
1189
a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> instead of a string, so it is slightly faster.
1190
1190
</p>
1191
1191
<p>
1192
1192
Use <a class="link" href="GtkObject.html#gtk-object-data-try-key" title="gtk_object_data_try_key"><code class="function">gtk_object_data_try_key()</code></a> and <a class="link" href="GtkObject.html#gtk-object-data-force-id" title="gtk_object_data_force_id"><code class="function">gtk_object_data_force_id()</code></a>
1239
1239
<a name="GtkObject.property-details"></a><h2>Property Details</h2>
1240
1240
<div class="refsect2" title='The "user-data" property'>
1241
1241
<a name="GtkObject--user-data"></a><h3>The <code class="literal">"user-data"</code> property</h3>
1242
 
<pre class="programlisting">  "user-data"                <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write</pre>
 
1242
<pre class="programlisting">  "user-data"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write</pre>
1243
1243
<p>Anonymous User Data Pointer.</p>
1244
1244
</div>
1245
1245
</div>
1248
1248
<div class="refsect2" title='The "destroy" signal'>
1249
1249
<a name="GtkObject-destroy"></a><h3>The <code class="literal">"destroy"</code> signal</h3>
1250
1250
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object,
1251
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Cleanup / No Recursion / No Hooks</pre>
 
1251
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Cleanup / No Recursion / No Hooks</pre>
1252
1252
<p>
1253
1253
Signals that all holders of a reference to the <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> should release
1254
1254
the reference that they hold. May result in finalization of the object
1273
1273
<div class="refsect1" title="See Also">
1274
1274
<a name="GtkObject.see-also"></a><h2>See Also</h2>
1275
1275
<p>
1276
 
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
 
1276
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
1277
1277
</p>
1278
1278
</div>
1279
1279
</div>