<html> <head><title>Gtk-- Reference: Gtk::Object</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Object</h1><p> <b> The base class of the whole hierarchy</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3ABase.html">Gtk::Base</a> <br> Derived by: <a href="Gtk::Data.html">Gtk::Data</a> <a href="Gtk::Widget.html">Gtk::Widget</a> <p> #include <gtk--/object.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt><tt>emitable</tt> <tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2215"><tt><font color=blue><b>destroy</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2216"><tt><font color=blue><b>destroy_</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gpointer</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2220"><tt><font color=blue><b>get_data</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gpointer</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2221"><tt><font color=blue><b>get_data_by_id</b></font></tt></a></td><td><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gpointer</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2218"><tt><font color=blue><b>get_user_data</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkObject</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2207"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkObject</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2208"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2209"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2213"><tt><font color=blue><b>nsignals</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2225"><tt><font color=blue><b>remove_data</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2227"><tt><font color=blue><b>remove_data_by_id</b></font></tt></a></td><td><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2226"><tt><font color=blue><b>remove_no_notify</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2228"><tt><font color=blue><b>remove_no_notify_by_id</b></font></tt></a></td><td><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2219"><tt><font color=blue><b>set_data</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2223"><tt><font color=blue><b>set_data_by_id</b></font></tt></a></td><td><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2224"><tt><font color=blue><b>set_data_by_id_full</b></font></tt></a></td><td><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>, <tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>destroy</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2222"><tt><font color=blue><b>set_data_full</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>, <tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>destroy</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2229"><tt><font color=blue><b>set_dynamic</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2217"><tt><font color=blue><b>set_user_data</b></font></tt></a></td><td><tt>(<tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>guint</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2212"><tt><font color=blue><b>signals</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>guint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2214"><tt><font color=blue><b>type</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2210"><tt><font color=blue><b>~Object</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td><tr><td colspan=3><h3>protected function member index:</h3></td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2235"><tt><font color=blue><b>destroy_notify_</b></font></tt></a></td><td><tt>(<tt><font color=purple>gpointer</font></tt> <tt><font color=blue>s</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2238"><tt><font color=blue><b>gtkmm_sigsegv</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=purple>char</font></tt>* <tt><font color=blue>name</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2231"><tt><font color=blue><b>reference</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2239"><tt><font color=blue><b>set_type</b></font></tt></a></td><td><tt>(<tt><font color=navy>GtkType</font></tt> <tt><font color=blue>type</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2232"><tt><font color=blue><b>unreference</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2236"><tt><font color=blue><b>weakref</b></font></tt></a></td><td><tt>(<tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>notify</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AObject.html#2237"><tt><font color=blue><b>weakunref</b></font></tt></a></td><td><tt>(<tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>notify</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> <tt><font color=navy><b>Gtk::Object</b></font></tt> is the root of the gtkmm type hierarchy. It serves a similar roles as java's Object class. It is used by the type-casting system to represent the base composite type. <P> Objects have arguments that are name/typed-value pairs. They may be readable or writable (or both or neither). The special handlers in every object are responsible for setting and getting these parameters. If the handler for a given argument must be called before the object may be used, be sure the <tt><font color=green>GTK_ARG_CONSTRUCT</font></tt> or <tt><font color=green>GTK_ARG_CONSTRUCT_ONLY</font></tt> flags are set; otherwise they are set only when the user does so. <P> Object also store a simpler association table, sometimes called the object_data. This is just an efficient mapping from a fixed set of strings to a gpointer. This can be used as arbitrary extra members. Notice that each new field name allocates a new quark, so it is probably best only to use this for fields with fixed names. <P> The primary difference between object_data and arguments is that the object defines two functions which set and get each type of argument. The object just has a table to store its object data in: it does not receive notice when data changes.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="2215"><font size=+1><b>Gtk::Object::destroy</b></font></a> - destroy object<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>emitable</tt> <tt>signal</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2215"><tt><font color=blue><b>destroy</b></font></tt></a><tt>()</tt>;<br><blockquote> This can be used to tell toplevel widgets that they should die if they are managed(). You should never connect a slot which references "this" because destroy is called during dtor.</blockquote> <br><br> <a name="2220"><font size=+1><b>Gtk::Object::get_data</b></font></a> - Get a named field from the object's table of associations (the object_data).<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>gpointer</font></tt></tt> <a href="Gtk%3A%3AObject.html#2220"><tt><font color=blue><b>get_data</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>) <tt>const</tt></tt>;<br><blockquote> key: Name of the key for that association. <P> Returns: The data if found, or NULL if no such data exists.</blockquote> <br><br> <a name="2221"><font size=+1><b>Gtk::Object::get_data_by_id</b></font></a> - Just like <a href="Gtk%3A%3AObject.html#2220"><tt><font color=blue><b>get_data</b></font></tt></a> except that it takes a GQuark instead of a string, so it is slightly faster.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>gpointer</font></tt></tt> <a href="Gtk%3A%3AObject.html#2221"><tt><font color=blue><b>get_data_by_id</b></font></tt></a><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>) <tt>const</tt></tt>;<br><blockquote> Use <tt><font color=blue><b></b></font></tt> and <tt><font color=blue><b></b></font></tt> to get an id from a string.</blockquote> <br><br> <a name="2218"><font size=+1><b>Gtk::Object::get_user_data</b></font></a> - Get the object's user data pointer.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>gpointer</font></tt></tt> <a href="Gtk%3A%3AObject.html#2218"><tt><font color=blue><b>get_user_data</b></font></tt></a><tt>() <tt>const</tt></tt>;<br><blockquote> This is intended to be a pointer for your convenience in writing applications.</blockquote> <br><br> <a name="2207"><font size=+1><b>Gtk::Object::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkObject</font></tt>*</tt> <a href="Gtk%3A%3AObject.html#2207"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="2209"><font size=+1><b>Gtk::Object::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3AObject.html#2209"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="2225"><font size=+1><b>Gtk::Object::remove_data</b></font></a> - Remove a specified datum from the object's data associations (the object_data).<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2225"><tt><font color=blue><b>remove_data</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>)</tt>;<br><blockquote> Subsequent calls to <a href="Gtk%3A%3AObject.html#2220"><tt><font color=blue><b>get_data</b></font></tt></a> will return NULL. <P> If you specified a destroy handler with <a href="Gtk%3A%3AObject.html#2222"><tt><font color=blue><b>set_data_full</b></font></tt></a>, it will be invoked. <P> key: Name of the key for that association.</blockquote> <br><br> <a name="2227"><font size=+1><b>Gtk::Object::remove_data_by_id</b></font></a> - Just like <a href="Gtk%3A%3AObject.html#2225"><tt><font color=blue><b>remove_data</b></font></tt></a> except that it takes a GQuark instead of a string, so it is slightly faster.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2227"><tt><font color=blue><b>remove_data_by_id</b></font></tt></a><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>)</tt>;<br><blockquote> Remove a specified datum from the object's data associations. Subsequent calls to <a href="Gtk%3A%3AObject.html#2220"><tt><font color=blue><b>get_data</b></font></tt></a> will return NULL. <P> Use <tt><font color=blue><b></b></font></tt> and <tt><font color=blue><b></b></font></tt> to get an id from a string. <P> data_id: Quark of the key.</blockquote> <br><br> <a name="2226"><font size=+1><b>Gtk::Object::remove_no_notify</b></font></a> - Remove a specified datum from the object's data associations (the object_data), without invoking the association's destroy handler.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2226"><tt><font color=blue><b>remove_no_notify</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>)</tt>;<br><blockquote> Just like <a href="Gtk%3A%3AObject.html#2225"><tt><font color=blue><b>remove_data</b></font></tt></a> except that any destroy handler will be ignored. Therefore this only affects data set using <a href="Gtk%3A%3AObject.html#2222"><tt><font color=blue><b>set_data_full</b></font></tt></a>. <P> key: Name of the key for that association.</blockquote> <br><br> <a name="2228"><font size=+1><b>Gtk::Object::remove_no_notify_by_id</b></font></a> - Just like <a href="Gtk%3A%3AObject.html#2226"><tt><font color=blue><b>remove_no_notify</b></font></tt></a> except that it takes a GQuark instead of a string, so it is slightly faster.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2228"><tt><font color=blue><b>remove_no_notify_by_id</b></font></tt></a><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>)</tt>;<br><blockquote> Use <tt><font color=blue><b></b></font></tt> and <tt><font color=blue><b></b></font></tt> to get an id from a string. <P> data_id: Quark of the key.</blockquote> <br><br> <a name="2219"><font size=+1><b>Gtk::Object::set_data</b></font></a> - Each object carries around a table of associations from strings to pointers. This function lets you set an association.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2219"><tt><font color=blue><b>set_data</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;<br><blockquote> If the object already had an association with that name, the old association will be destroyed. key: Name of the key. <P> data: Data to associate with that key.</blockquote> <br><br> <a name="2223"><font size=+1><b>Gtk::Object::set_data_by_id</b></font></a> - Just like <a href="Gtk%3A%3AObject.html#2219"><tt><font color=blue><b>set_data</b></font></tt></a> except that it takes a GQuark instead of a string, so it is slightly faster.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2223"><tt><font color=blue><b>set_data_by_id</b></font></tt></a><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;<br><blockquote> Use <tt><font color=blue><b></b></font></tt> and <tt><font color=blue><b></b></font></tt> to get an id from a string. <P> data_id: Quark of the key. <P> data: Data to associate with that key.</blockquote> <br><br> <a name="2224"><font size=+1><b>Gtk::Object::set_data_by_id_full</b></font></a> - Just like <a href="Gtk%3A%3AObject.html#2222"><tt><font color=blue><b>set_data_full</b></font></tt></a> except that it takes a GQuark instead of a string, so it is slightly faster.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2224"><tt><font color=blue><b>set_data_by_id_full</b></font></tt></a><tt>(<tt><font color=navy>GQuark</font></tt> <tt><font color=blue>data_id</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>, <tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>destroy</font></tt>)</tt>;<br><blockquote> Use <tt><font color=blue><b></b></font></tt> and <tt><font color=blue><b></b></font></tt> to get an id from a string. <P> data_id: Quark of the key. <P> data: Data to associate with that key. <P> destroy: Function to call when the association is destroyed.</blockquote> <br><br> <a name="2222"><font size=+1><b>Gtk::Object::set_data_full</b></font></a> - Like <a href="Gtk%3A%3AObject.html#2219"><tt><font color=blue><b>set_data</b></font></tt></a> except it adds notification for when the association is destroyed, either by <a href="Gtk%3A%3AObject.html#2225"><tt><font color=blue><b>remove_data</b></font></tt></a> or when the object is destroyed.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2222"><tt><font color=blue><b>set_data_full</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>key</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>, <tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>destroy</font></tt>)</tt>;<br><blockquote> key: Name of the key. <P> data: Data to associate with that key. <P> destroy: Function to call when the association is destroyed.</blockquote> <br><br> <a name="2217"><font size=+1><b>Gtk::Object::set_user_data</b></font></a> - For convenience, every object offers a generic user data pointer. This function sets it.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2217"><tt><font color=blue><b>set_user_data</b></font></tt></a><tt>(<tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;<br><br> <a name="2236"><font size=+1><b>Gtk::Object::weakref</b></font></a> - Adds a weak reference callback to an object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2236"><tt><font color=blue><b>weakref</b></font></tt></a><tt>(<tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>notify</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;<br><blockquote> Weak references are a mechanism to safely keep a pointer to an object without using the reference counting mechansim. They use a callback function to receive notice that the object is about to be freed (aka finalized). This happens after the destroy callback has been run. <P> notify: Callback to invoke before the object is freed. data: Extra data to pass to notify.</blockquote> <br><br> <a name="2237"><font size=+1><b>Gtk::Object::weakunref</b></font></a> - Removes a weak reference callback to an object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AObject.html#2237"><tt><font color=blue><b>weakunref</b></font></tt></a><tt>(<tt><font color=navy>GtkDestroyNotify</font></tt> <tt><font color=blue>notify</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>)</tt>;<br><blockquote> notify: Callback to search for. data: Data to search for.</blockquote> <br><br> <hr noshade> <h2>Variable Member Descriptions:</h2> <hr noshade> </html>