gtkobject.html

最新gtk中文资料集

<div class="refsect2" lang="en">
<a name="id4279333"></a><h3>
<a name="gtk-object-get"></a>gtk_object_get ()</h3>
<a class="indexterm" name="id4279349"></a><pre class="programlisting">void                gtk_object_get                      (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *first_property_name,
                                                         ...);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<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>
</div>
<p>
Gets properties of an object. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_property_name</code></em>&#160;:</span></p></td>
<td>name of first property to get the value for.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td>
<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>-terminated list of name-return location pairs.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4279474"></a><h3>
<a name="gtk-object-set"></a>gtk_object_set ()</h3>
<a class="indexterm" name="id4279490"></a><pre class="programlisting">void                gtk_object_set                      (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *first_property_name,
                                                         ...);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<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>
</div>
<p>
Sets properties on an object. 
</p>
<p>
</p>
<div class="informalexample"><pre class="programlisting">
void set_box_properties (GtkBox* box)
{
  gtk_object_set (GTK_OBJECT (box), "homogeneous", TRUE,
                                    "spacing", 8,
				    NULL);
}
</pre></div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_property_name</code></em>&#160;:</span></p></td>
<td>name of the first property to set
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td>the value of the first argument, followed optionally
by more name/value pairs, followed by <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4279631"></a><h3>
<a name="gtk-object-set-data"></a>gtk_object_set_data ()</h3>
<a class="indexterm" name="id4279647"></a><pre class="programlisting">void                gtk_object_set_data                 (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<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>
</div>
<p>
Each object carries around a table of associations from
strings to pointers.  This function lets you set an association.
</p>
<p>
If the object already had an association with that name,
the old association will be destroyed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>object containing the associations.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
<td>name of the key.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>data to associate with that key.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4279769"></a><h3>
<a name="gtk-object-set-data-full"></a>gtk_object_set_data_full ()</h3>
<a class="indexterm" name="id4279785"></a><pre class="programlisting">void                gtk_object_set_data_full            (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a class="link" href="gtk-Types.html#GtkDestroyNotify">GtkDestroyNotify</a> destroy);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<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>
</div>
<p>
Like <a class="link" href="GtkObject.html#gtk-object-set-data"><code class="function">gtk_object_set_data()</code></a> except it adds notification
for when the association is destroyed, either by
<a class="link" href="GtkObject.html#gtk-object-remove-data"><code class="function">gtk_object_remove_data()</code></a> or when the object is destroyed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>object containing the associations.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
<td>name of the key.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>data to associate with that key.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>destroy</code></em>&#160;:</span></p></td>
<td>function to call when the association is destroyed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4279947"></a><h3>
<a name="gtk-object-remove-data"></a>gtk_object_remove_data ()</h3>
<a class="indexterm" name="id4279964"></a><pre class="programlisting">void                gtk_object_remove_data              (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<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/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> instead.</p>
</div>
<p>
Removes a specified datum from the object's data associations (the object_data).
Subsequent calls to <a class="link" href="GtkObject.html#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>.
</p>
<p>
If you specified a destroy handler with <a class="link" href="GtkObject.html#gtk-object-set-data-full"><code class="function">gtk_object_set_data_full()</code></a>,
it will be invoked.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>the object maintaining the association.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
<td>name of the key for that association.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4280105"></a><h3>
<a name="gtk-object-get-data"></a>gtk_object_get_data ()</h3>
<a class="indexterm" name="id4280121"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>            gtk_object_get_data                 (<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<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>
</div>
<p>
Get a named field from the object's table of associations (the object_data).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>the object maintaining the associations.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
<td>name of the key for that association.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>