~ubuntu-branches/ubuntu/trusty/gtk+2.0/trusty

<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> * <a class="link" href="GtkObject.html#gtk-object-new" title="gtk_object_new ()">gtk_object_new</a> (<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> type</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

<code>const gchar *first_property_name</code>,

<code>...</code>);

void <a class="link" href="GtkObject.html#gtk-object-sink" title="gtk_object_sink ()">gtk_object_sink</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);

<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> * <a class="link" href="GtkObject.html#gtk-object-ref" title="gtk_object_ref ()">gtk_object_ref</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);

void <a class="link" href="GtkObject.html#gtk-object-unref" title="gtk_object_unref ()">gtk_object_unref</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);

void <a class="link" href="GtkObject.html#gtk-object-weakref" title="gtk_object_weakref ()">gtk_object_weakref</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> notify</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<code>GDestroyNotify notify</code>,

<code>gpointer data</code>);

void <a class="link" href="GtkObject.html#gtk-object-weakunref" title="gtk_object_weakunref ()">gtk_object_weakunref</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> notify</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<code>GDestroyNotify notify</code>,

<code>gpointer data</code>);

void <a class="link" href="GtkObject.html#gtk-object-destroy" title="gtk_object_destroy ()">gtk_object_destroy</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);

void <a class="link" href="GtkObject.html#gtk-object-get" title="gtk_object_get ()">gtk_object_get</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

<code>const gchar *first_property_name</code>,

<code>...</code>);

void <a class="link" href="GtkObject.html#gtk-object-set" title="gtk_object_set ()">gtk_object_set</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

<code>const gchar *first_property_name</code>,

<code>...</code>);

void <a class="link" href="GtkObject.html#gtk-object-set-data" title="gtk_object_set_data ()">gtk_object_set_data</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<code>const gchar *key</code>,

<code>gpointer data</code>);

void <a class="link" href="GtkObject.html#gtk-object-set-data-full" title="gtk_object_set_data_full ()">gtk_object_set_data_full</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);

<code>const gchar *key</code>,

<code>gpointer data</code>,

<code>GDestroyNotify destroy</code>);

void <a class="link" href="GtkObject.html#gtk-object-remove-data" title="gtk_object_remove_data ()">gtk_object_remove_data</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()">gtk_object_get_data</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);

<code>const gchar *key</code>);

gpointer <a class="link" href="GtkObject.html#gtk-object-get-data" title="gtk_object_get_data ()">gtk_object_get_data</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const gchar *key</code>);

void <a class="link" href="GtkObject.html#gtk-object-remove-no-notify" title="gtk_object_remove_no_notify ()">gtk_object_remove_no_notify</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);

<code>const gchar *key</code>);

void <a class="link" href="GtkObject.html#gtk-object-set-user-data" title="gtk_object_set_user_data ()">gtk_object_set_user_data</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="GtkObject.html#gtk-object-get-user-data" title="gtk_object_get_user_data ()">gtk_object_get_user_data</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);

void <a class="link" href="GtkObject.html#gtk-object-add-arg-type" title="gtk_object_add_arg_type ()">gtk_object_add_arg_type</a> (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *arg_name</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> arg_type</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> arg_flags</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> arg_id</code>);

<code>gpointer data</code>);

gpointer <a class="link" href="GtkObject.html#gtk-object-get-user-data" title="gtk_object_get_user_data ()">gtk_object_get_user_data</a> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);

void <a class="link" href="GtkObject.html#gtk-object-add-arg-type" title="gtk_object_add_arg_type ()">gtk_object_add_arg_type</a> (<code>const gchar *arg_name</code>,

<code>GType arg_type</code>,

<code>guint arg_flags</code>,

<code>guint arg_id</code>);

void <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> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<code>GQuark data_id</code>,

<code>gpointer data</code>);

void <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> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>,

100

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

101

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);

102

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</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> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

103

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>);

<code>GQuark data_id</code>,

100

<code>gpointer data</code>,

101

<code>GDestroyNotify destroy</code>);

102

gpointer <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> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

103

<code>GQuark data_id</code>);

104

void <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> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

105

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>);

105

<code>GQuark data_id</code>);

106

void <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> (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> key_id</code>);

107

<code>GQuark key_id</code>);

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

#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

</pre>

112

113

<a name="GtkObject.object-hierarchy"></a><h2>Object Hierarchy</h2>

114

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>

115

GObject

116

+----GInitiallyUnowned

117

+----GtkObject

118

+----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>

119

+----<a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>

128

129

<a name="GtkObject.properties"></a><h2>Properties</h2>

130

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">gpointer</a> : Read / Write

131

"<a class="link" href="GtkObject.html#GtkObject--user-data" title='The "user-data" property'>user-data</a>" gpointer : Read / Write

132

</pre>

133

</div>

134

135

<a name="GtkObject.signals"></a><h2>Signals</h2>

136

137

"<a class="link" href="GtkObject.html#GtkObject-destroy" title='The "destroy" signal'>destroy</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS"><code class="literal">No Hooks</code></a>

137

"<a class="link" href="GtkObject.html#GtkObject-destroy" title='The "destroy" signal'>destroy</a>" : <code class="literal">No Hooks</code>

138

</pre>

139

</div>

140

141

<a name="GtkObject.description"></a><h2>Description</h2>

142

143

<a name="idm266978252288"></a><h3>Description</h3>

143

<a name="idm140406187218256"></a><h3>Description</h3>

144

145

<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> is the base class for all widgets, and for a few

146

non-widget objects such as <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>. <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> predates

147

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>; non-widgets that derive from <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> rather than

148

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> do so for backward compatibility reasons.

147

GObject; non-widgets that derive from <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> rather than

148

GObject do so for backward compatibility reasons.

149

150

151

<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>s are created with a "floating" reference count.

152

This means that the initial reference is not owned by anyone. Calling

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">GtkObject</a> is incorrect, the floating

153

<code class="function">g_object_unref()</code> on a newly-created <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> is incorrect, the floating

154

reference has to be removed first. This can be done by anyone at any time,

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

155

by calling <code class="function">g_object_ref_sink()</code> to convert the floating reference into a

156

regular reference. <code class="function">g_object_ref_sink()</code> returns a new reference if an object

157

is already sunk (has no floating reference).

158

159

165

<tbody>

166

<tr>

167

168

<td class="listing_code"><pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref-sink">g_object_ref_sink</a> (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a> (child_widget));</pre></td>

168

<td class="listing_code"><pre class="programlisting">g_object_ref_sink (G_OBJECT (child_widget));</pre></td>

169

</tr>

170

</tbody>

171

</table>

222

223

224

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>,

225

Never call <code class="function">g_object_unref()</code> unless you have previously called <code class="function">g_object_ref()</code>,

226

even if you created the <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>. (Note: this is not

227

true for <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>; for <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>, the creator of the object owns a reference.)

227

true for GObject; for GObject, the creator of the object owns a reference.)

228

</li>

229

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

</li>

233

<li class="listitem"> Because of the floating reference count, you don't need to

234

worry about reference counting for widgets and toplevel windows, unless you

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.</li>

235

explicitly call <code class="function">g_object_ref()</code> yourself.</li>

236

</ul></div>

237

238

255

</pre>

256

257

<h3 class="title">Warning</h3>

258

<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.

258

<code class="literal">GTK_OBJECT_TYPE</code> has been deprecated since version 2.20 and should not be used in newly-written code. Use <code class="function">G_OBJECT_TYPE()</code> instead.

259

</div>

260

261

Gets the type of an object.

278

</pre>

279

280

<h3 class="title">Warning</h3>

281

<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.

281

<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 <code class="function">G_OBJECT_TYPE_NAME()</code> instead.

282

</div>

283

284

Gets the name of an object's type.

377

<code class="literal">GTK_OBJECT_FLOATING</code> is deprecated and should not be used in newly-written code.

378

</div>

379

380

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.

380

Evaluates to <code class="literal">TRUE</code> if the object still has its floating reference count.

381

See the overview documentation for <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>.

382

383

404

</pre>

405

406

<h3 class="title">Warning</h3>

407

<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">GParamSpec</a> features instead

407

<code class="literal">GtkArgFlags</code> is deprecated and should not be used in newly-written code. Use corresponding GParamSpec features instead

408

</div>

409

410

Possible flags indicating how an argument should be treated.

450

<hr>

451

452

<a name="gtk-object-new"></a><h3>gtk_object_new ()</h3>

453

<pre class="programlisting"><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> * gtk_object_new (<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> type</code>,

454

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

453

454

<code>const gchar *first_property_name</code>,

455

456

457

<h3 class="title">Warning</h3>

458

<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.

458

<code class="literal">gtk_object_new</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_new()</code> instead.

459

</div>

460

461

Constructs an object given its arguments, enumerated in the call to the

491

<pre class="programlisting">void gtk_object_sink (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);</pre>

492

493

<h3 class="title">Warning</h3>

494

<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

494

<code class="literal">gtk_object_sink</code> has been deprecated since version 2.10 and should not be used in newly-written code. Use <code class="function">g_object_ref_sink()</code> instead

495

</div>

496

497

Removes the floating reference from a <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>, if it exists;

515

<pre class="programlisting"><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> * gtk_object_ref (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);</pre>

516

517

<h3 class="title">Warning</h3>

518

<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.

518

<code class="literal">gtk_object_ref</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_ref()</code> instead.

519

</div>

520

521

Increases the reference count of the object.

544

<pre class="programlisting">void gtk_object_unref (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);</pre>

545

546

<h3 class="title">Warning</h3>

547

<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.

547

<code class="literal">gtk_object_unref</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_unref()</code> instead.

548

</div>

549

550

Decreases the reference count of an object. When its reference count drops

565

566

<a name="gtk-object-weakref"></a><h3>gtk_object_weakref ()</h3>

567

<pre class="programlisting">void gtk_object_weakref (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

568

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> notify</code>,

569

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

568

<code>GDestroyNotify notify</code>,

569

<code>gpointer data</code>);</pre>

570

571

<h3 class="title">Warning</h3>

572

<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.

572

<code class="literal">gtk_object_weakref</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_weak_ref()</code> instead.

573

</div>

574

575

Adds a weak reference callback to an object. Weak references are used for notification when an object is

576

finalized. They are called "weak references" because they allow you to safely

577

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

577

hold a pointer to an object without calling <code class="function">g_object_ref()</code> (<code class="function">g_object_ref()</code> adds

578

a strong reference, that is, forces the object to stay alive).

579

580

602

603

<a name="gtk-object-weakunref"></a><h3>gtk_object_weakunref ()</h3>

604

<pre class="programlisting">void gtk_object_weakunref (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

605

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> notify</code>,

606

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

605

<code>GDestroyNotify notify</code>,

606

<code>gpointer data</code>);</pre>

607

608

<h3 class="title">Warning</h3>

609

<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.

609

<code class="literal">gtk_object_weakunref</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_weak_unref()</code> instead.

610

</div>

611

612

Removes a weak reference callback to an object.

665

666

<a name="gtk-object-get"></a><h3>gtk_object_get ()</h3>

667

<pre class="programlisting">void gtk_object_get (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

668

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

668

<code>const gchar *first_property_name</code>,

669

670

671

<h3 class="title">Warning</h3>

672

<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.

672

<code class="literal">gtk_object_get</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_get()</code> instead.

673

</div>

674

675

Gets properties of an object.

695

696

<a name="gtk-object-set"></a><h3>gtk_object_set ()</h3>

697

<pre class="programlisting">void gtk_object_set (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

698

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

698

<code>const gchar *first_property_name</code>,

699

700

701

<h3 class="title">Warning</h3>

702

<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.

702

<code class="literal">gtk_object_set</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set()</code> instead.

703

</div>

704

705

Sets properties on an object.

718

6</pre></td>

719

<td class="listing_code"><pre class="programlisting">void set_box_properties (<a href="GtkBox.html">GtkBox</a>* box)

720

{

721

<a href="GtkObject.html#gtk-object-set">gtk_object_set</a> (GTK_OBJECT (box), "homogeneous", <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a>,

721

722

"spacing", 8,

723

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);

723

<a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a>);

724

}</pre></td>

725

</tr>

726

</tbody>

750

751

<a name="gtk-object-set-data"></a><h3>gtk_object_set_data ()</h3>

752

<pre class="programlisting">void gtk_object_set_data (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

753

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

754

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

753

<code>const gchar *key</code>,

754

<code>gpointer data</code>);</pre>

755

756

<h3 class="title">Warning</h3>

757

<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.

757

<code class="literal">gtk_object_set_data</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set_data()</code> instead.

758

</div>

759

760

Each object carries around a table of associations from

789

790

<a name="gtk-object-set-data-full"></a><h3>gtk_object_set_data_full ()</h3>

791

<pre class="programlisting">void gtk_object_set_data_full (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

792

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

793

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

794

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

792

<code>const gchar *key</code>,

793

<code>gpointer data</code>,

794

<code>GDestroyNotify destroy</code>);</pre>

795

796

<h3 class="title">Warning</h3>

797

<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.

797

<code class="literal">gtk_object_set_data_full</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set_data_full()</code> instead.

798

</div>

799

800

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

830

831

<a name="gtk-object-remove-data"></a><h3>gtk_object_remove_data ()</h3>

832

<pre class="programlisting">void gtk_object_remove_data (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

833

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);</pre>

833

<code>const gchar *key</code>);</pre>

834

835

<h3 class="title">Warning</h3>

836

<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.

836

<code class="literal">gtk_object_remove_data</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set_data()</code> to set the object data to <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.

837

</div>

838

839

Removes a specified datum from the object's data associations (the object_data).

840

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>.

840

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/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

841

842

843

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>,

863

<hr>

864

865

<a name="gtk-object-get-data"></a><h3>gtk_object_get_data ()</h3>

866

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> gtk_object_get_data (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

867

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);</pre>

866

<pre class="programlisting">gpointer gtk_object_get_data (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

867

<code>const gchar *key</code>);</pre>

868

869

<h3 class="title">Warning</h3>

870

<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.

870

<code class="literal">gtk_object_get_data</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_get_data()</code> instead.

871

</div>

872

873

Get a named field from the object's table of associations (the object_data).

888

</tr>

889

<tr>

890

<td>Returns :</td>

891

<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.</td>

891

<td>the data if found, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.</td>

892

</tr>

893

</tbody>

894

</table></div>

897

898

<a name="gtk-object-remove-no-notify"></a><h3>gtk_object_remove_no_notify ()</h3>

899

<pre class="programlisting">void gtk_object_remove_no_notify (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

900

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);</pre>

900

<code>const gchar *key</code>);</pre>

901

902

<h3 class="title">Warning</h3>

903

<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.

903

<code class="literal">gtk_object_remove_no_notify</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_steal_data()</code> instead.

904

</div>

905

906

Remove a specified datum from the object's data associations (the object_data),

932

933

<a name="gtk-object-set-user-data"></a><h3>gtk_object_set_user_data ()</h3>

934

<pre class="programlisting">void gtk_object_set_user_data (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

935

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

935

<code>gpointer data</code>);</pre>

936

937

<h3 class="title">Warning</h3>

938

<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.

938

<code class="literal">gtk_object_set_user_data</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set_data()</code> instead.

939

</div>

940

941

For convenience, every object offers a generic user data

961

<hr>

962

963

<a name="gtk-object-get-user-data"></a><h3>gtk_object_get_user_data ()</h3>

964

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> gtk_object_get_user_data (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);</pre>

964

<pre class="programlisting">gpointer gtk_object_get_user_data (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);</pre>

965

966

<h3 class="title">Warning</h3>

967

<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.

967

<code class="literal">gtk_object_get_user_data</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_get_data()</code> instead.

968

</div>

969

970

Get the object's user data pointer.

993

<hr>

994

995

<a name="gtk-object-add-arg-type"></a><h3>gtk_object_add_arg_type ()</h3>

996

<pre class="programlisting">void gtk_object_add_arg_type (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *arg_name</code>,

997

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> arg_type</code>,

998

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> arg_flags</code>,

999

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> arg_id</code>);</pre>

996

<pre class="programlisting">void gtk_object_add_arg_type (<code>const gchar *arg_name</code>,

997

<code>GType arg_type</code>,

998

<code>guint arg_flags</code>,

999

<code>guint arg_id</code>);</pre>

1000

1001

<h3 class="title">Warning</h3>

1002

<code class="literal">gtk_object_add_arg_type</code> is deprecated and should not be used in newly-written code.

1003

</div>

1004

1005

Deprecated in favor of the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> property system including <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec">GParamSpec</a>.

1005

Deprecated in favor of the GObject property system including GParamSpec.

1006

Add a new type of argument to an object class.

1007

Usually this is called when registering a new type of object.

1008

1037

1038

<a name="gtk-object-set-data-by-id"></a><h3>gtk_object_set_data_by_id ()</h3>

1039

<pre class="programlisting">void gtk_object_set_data_by_id (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

1040

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>,

1041

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1040

<code>GQuark data_id</code>,

1041

<code>gpointer data</code>);</pre>

1042

1043

<h3 class="title">Warning</h3>

1044

<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.

1044

<code class="literal">gtk_object_set_data_by_id</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set_qdata()</code> instead.

1045

</div>

1046

1047

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

1048

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> instead of a string, so it is slightly faster.

1048

a GQuark instead of a string, so it is slightly faster.

1049

1050

1051

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>

1076

1077

<a name="gtk-object-set-data-by-id-full"></a><h3>gtk_object_set_data_by_id_full ()</h3>

1078

<pre class="programlisting">void gtk_object_set_data_by_id_full (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

1079

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>,

1080

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1081

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

1079

<code>GQuark data_id</code>,

1080

<code>gpointer data</code>,

1081

<code>GDestroyNotify destroy</code>);</pre>

1082

1083

<h3 class="title">Warning</h3>

1084

<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.

1084

<code class="literal">gtk_object_set_data_by_id_full</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set_qdata_full()</code> instead.

1085

</div>

1086

1087

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

1088

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> instead of a string, so it is slightly faster.

1088

a GQuark instead of a string, so it is slightly faster.

1089

1090

1091

1119

<hr>

1120

1121

<a name="gtk-object-get-data-by-id"></a><h3>gtk_object_get_data_by_id ()</h3>

1122

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> gtk_object_get_data_by_id (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

1123

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>);</pre>

1122

<pre class="programlisting">gpointer gtk_object_get_data_by_id (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

1123

<code>GQuark data_id</code>);</pre>

1124

1125

<h3 class="title">Warning</h3>

1126

<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.

1126

<code class="literal">gtk_object_get_data_by_id</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_get_qdata()</code> instead.

1127

</div>

1128

1129

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

1130

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> instead of a string, so it is slightly faster.

1130

a GQuark instead of a string, so it is slightly faster.

1131

1132

1133

1149

</tr>

1150

<tr>

1151

<td>Returns :</td>

1152

<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.</td>

1152

<td>the data if found, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.</td>

1153

</tr>

1154

</tbody>

1155

</table></div>

1158

1159

<a name="gtk-object-remove-data-by-id"></a><h3>gtk_object_remove_data_by_id ()</h3>

1160

<pre class="programlisting">void gtk_object_remove_data_by_id (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

1161

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> data_id</code>);</pre>

1161

<code>GQuark data_id</code>);</pre>

1162

1163

<h3 class="title">Warning</h3>

1164

<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.

1164

<code class="literal">gtk_object_remove_data_by_id</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_set_qdata()</code> with data of <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.

1165

</div>

1166

1167

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

1168

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> instead of a string, so it is slightly faster.

1168

a GQuark instead of a string, so it is slightly faster.

1169

1170

1171

Remove a specified datum from the object's data associations.

1172

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/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1173

1174

1175

1196

1197

<a name="gtk-object-remove-no-notify-by-id"></a><h3>gtk_object_remove_no_notify_by_id ()</h3>

1198

<pre class="programlisting">void gtk_object_remove_no_notify_by_id (<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>,

1199

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> key_id</code>);</pre>

1199

<code>GQuark key_id</code>);</pre>

1200

1201

<h3 class="title">Warning</h3>

1202

<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.

1202

<code class="literal">gtk_object_remove_no_notify_by_id</code> is deprecated and should not be used in newly-written code. Use <code class="function">g_object_steal_qdata()</code> instead.

1203

</div>

1204

1205

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

1206

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> instead of a string, so it is slightly faster.

1206

a GQuark instead of a string, so it is slightly faster.

1207

1208

1209

1257

<a name="GtkObject.property-details"></a><h2>Property Details</h2>

1258

1259

<a name="GtkObject--user-data"></a><h3>The <code class="literal">"user-data"</code> property</h3>

1260

<pre class="programlisting"> "user-data" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> : Read / Write</pre>

1260

<pre class="programlisting"> "user-data" gpointer : Read / Write</pre>

1261

Anonymous User Data Pointer.

1262

</div>

1263

</div>

1266

1267

<a name="GtkObject-destroy"></a><h3>The <code class="literal">"destroy"</code> signal</h3>

1268

<pre class="programlisting">void user_function (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,

1269

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS"><code class="literal">No Hooks</code></a></pre>

1269

gpointer user_data) : <code class="literal">No Hooks</code></pre>

1270

1271

Signals that all holders of a reference to the <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> should release

1272

the reference that they hold. May result in finalization of the object

1293

1294

1295

1296

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

1296

GObject

1297

1298

</div>

1299

</div>

Older »