~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> or <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, indicating whether <code>type</code>

883

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, indicating whether <code>type</code>

884

is a <a class="link" href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS" title="G_TYPE_OBJECT"><code class="literal">G_TYPE_OBJECT</code></a>.

885

886

</div>

1123

<a name="g-object-class-install-property"></a><h3>g_object_class_install_property ()</h3>

1124

<pre class="programlisting">void

1125

g_object_class_install_property (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> *oclass</code>,

1126

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> property_id</code>,

1126

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

1127

<code><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> *pspec</code>);</pre>

1128

Installs a new property. This is usually done in the class initializer.

1129

Note that it is possible to redefine a property in a derived class,

1162

<a name="g-object-class-install-properties"></a><h3>g_object_class_install_properties ()</h3>

1163

<pre class="programlisting">void

1164

g_object_class_install_properties (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> *oclass</code>,

1165

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> n_pspecs</code>,

1165

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

1166

<code><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> **pspecs</code>);</pre>

1167

Installs new properties from an array of <a href="gobject-GParamSpec.html#GParamSpec">GParamSpecs</a>. This is

1168

usually done in the class initializer.

1304

<a name="g-object-class-find-property"></a><h3>g_object_class_find_property ()</h3>

1305

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> *

1306

g_object_class_find_property (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> *oclass</code>,

1307

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *property_name</code>);</pre>

1307

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

1308

Looks up the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> for a property of a class.

1309

1310

<a name="id-1.4.5.10.17.5"></a><h4>Parameters</h4>

1331

1332

<a name="id-1.4.5.10.17.6"></a><h4>Returns</h4>

1333

the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> for the property, or

1334

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the class doesn't have a property of that name.

1334

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the class doesn't have a property of that name.

1335

[<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1336

</div>

1337

</div>

1340

<a name="g-object-class-list-properties"></a><h3>g_object_class_list_properties ()</h3>

1341

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> **

1342

g_object_class_list_properties (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> *oclass</code>,

1343

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> *n_properties</code>);</pre>

1343

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

1344

Get an array of <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a>* for all properties of a class.

1345

1346

<a name="id-1.4.5.10.18.5"></a><h4>Parameters</h4>

1376

<a name="g-object-class-override-property"></a><h3>g_object_class_override_property ()</h3>

1377

<pre class="programlisting">void

1378

g_object_class_override_property (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> *oclass</code>,

1379

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> property_id</code>,

1380

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>);</pre>

1379

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

1380

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

1381

Registers <code>property_id</code>

1382

as referring to a property with the name

1383

1433

1434

<a name="g-object-interface-install-property"></a><h3>g_object_interface_install_property ()</h3>

1435

<pre class="programlisting">void

1436

g_object_interface_install_property (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

1436

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

1437

<code><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> *pspec</code>);</pre>

1438

Add a property to an interface; this is only useful for interfaces

1439

that are added to GObject-derived types. Adding a property to an

1479

1480

<a name="g-object-interface-find-property"></a><h3>g_object_interface_find_property ()</h3>

1481

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> *

1482

g_object_interface_find_property (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

1483

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *property_name</code>);</pre>

1482

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

1483

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

1484

Find the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> with the given name for an

1485

interface. Generally, the interface vtable passed in as <code>g_iface</code>

1486

1514

<a name="id-1.4.5.10.21.6"></a><h4>Returns</h4>

1515

the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> for the property of the

1516

interface with the name <code>property_name</code>

1517

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no

1517

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no

1518

such property exists.

1519

[<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1520

</div>

1524

1525

<a name="g-object-interface-list-properties"></a><h3>g_object_interface_list_properties ()</h3>

1526

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> **

1527

g_object_interface_list_properties (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

1528

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> *n_properties_p</code>);</pre>

1527

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

1528

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

1529

Lists the properties of an interface.Generally, the interface

1530

vtable passed in as <code>g_iface</code>

1531

will be the default vtable from

1559

a

1560

pointer to an array of pointers to <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a>

1561

structures. The paramspecs are owned by GLib, but the

1562

array should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when you are done with

1562

array should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when you are done with

1563

it.

1564

[<acronym title="Parameter points to an array of items.">array</acronym> length=n_properties_p][<acronym title="Free data container after the code is done.">transfer container</acronym>]

1565

</div>

1568

<hr>

1569

1570

<a name="g-object-new"></a><h3>g_object_new ()</h3>

1571

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

1571

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

1572

g_object_new (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

1573

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

1573

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

1574

1575

Creates a new instance of a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> subtype and sets its properties.

1576

Construction parameters (see <a class="link" href="gobject-GParamSpec.html#G-PARAM-CONSTRUCT:CAPS">G_PARAM_CONSTRUCT</a>, <a class="link" href="gobject-GParamSpec.html#G-PARAM-CONSTRUCT-ONLY:CAPS">G_PARAM_CONSTRUCT_ONLY</a>)

1597

<tr>

1598

1599

<td class="parameter_description">the value of the first property, followed optionally by more

1600

name/value pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1600

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

1601

1602

</tr>

1603

</tbody>

1613

<hr>

1614

1615

<a name="g-object-newv"></a><h3>g_object_newv ()</h3>

1616

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

1616

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

1617

g_object_newv (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

1618

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> n_parameters</code>,

1618

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

1619

<code><a class="link" href="gobject-The-Base-Object-Type.html#GParameter" title="struct GParameter">GParameter</a> *parameters</code>);</pre>

1620

Creates a new instance of a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> subtype and sets its properties.

1621

1660

<hr>

1661

1662

<a name="g-object-ref"></a><h3>g_object_ref ()</h3>

1663

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

1664

g_object_ref (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);</pre>

1663

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

1664

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

1665

Increases the reference count of <code>object</code>

1666

.

1667

1690

1691

<a name="g-object-unref"></a><h3>g_object_unref ()</h3>

1692

<pre class="programlisting">void

1693

g_object_unref (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);</pre>

1693

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

1694

Decreases the reference count of <code>object</code>

1695

. When its reference count

1696

drops to 0, the object is finalized (i.e. its memory is freed).

1713

<hr>

1714

1715

<a name="g-object-ref-sink"></a><h3>g_object_ref_sink ()</h3>

1716

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

1717

g_object_ref_sink (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);</pre>

1716

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

1717

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

1718

Increase the reference count of <code>object</code>

1719

, and possibly remove the

1720

<a class="link" href="gobject-The-Base-Object-Type.html#floating-ref" title="Floating references">floating</a> reference, if <code>object</code>

1754

g_clear_object (<code>volatile <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> **object_ptr</code>);</pre>

1755

Clears a reference to a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a>.

1756

<code>object_ptr</code>

1757

must not be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1758

If the reference is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then this function does nothing.

1757

must not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1758

If the reference is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then this function does nothing.

1759

Otherwise, the reference count of the object is decreased and the

1760

pointer is set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1760

pointer is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1761

This function is threadsafe and modifies the pointer atomically,

1762

using memory barriers where needed.

1763

A macro is also included that allows this function to be used without

1782

<hr>

1783

1784

<a name="g-object-is-floating"></a><h3>g_object_is_floating ()</h3>

1785

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1786

g_object_is_floating (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);</pre>

1785

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

1786

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

1787

Checks whether <code>object</code>

1788

has a <a class="link" href="gobject-The-Base-Object-Type.html#floating-ref" title="Floating references">floating</a> reference.

1789

1803

</div>

1804

1805

<a name="id-1.4.5.10.29.6"></a><h4>Returns</h4>

1806

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <code>object</code>

1806

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <code>object</code>

1807

has a floating reference

1808

1809

</div>

1839

1840

<a name="GWeakNotify"></a><h3>GWeakNotify ()</h3>

1841

<pre class="programlisting">void

1842

(*GWeakNotify) (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1842

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

1843

<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *where_the_object_was</code>);</pre>

1844

A <a class="link" href="gobject-The-Base-Object-Type.html#GWeakNotify" title="GWeakNotify ()">GWeakNotify</a> function can be added to an object as a callback that gets

1845

triggered when the object is finalized. Since the object is already being

1874

<pre class="programlisting">void

1875

g_object_weak_ref (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

1876

<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakNotify" title="GWeakNotify ()">GWeakNotify</a> notify</code>,

1877

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1877

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

1878

Adds a weak reference callback to an object. Weak references are

1879

used for notification when an object is finalized. They are called

1880

"weak references" because they allow you to safely hold a pointer

1918

<pre class="programlisting">void

1919

g_object_weak_unref (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

1920

<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakNotify" title="GWeakNotify ()">GWeakNotify</a> notify</code>,

1921

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1921

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

1922

Removes a weak reference callback to an object.

1923

1924

<a name="id-1.4.5.10.33.5"></a><h4>Parameters</h4>

1953

<a name="g-object-add-weak-pointer"></a><h3>g_object_add_weak_pointer ()</h3>

1954

<pre class="programlisting">void

1955

g_object_add_weak_pointer (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

1956

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> *weak_pointer_location</code>);</pre>

1956

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

1957

Adds a weak reference from weak_pointer to <code>object</code>

1958

to indicate that

1959

the pointer located at <code>weak_pointer_location</code>

1962

. When the <code>object</code>

1963

is finalized,

1964

<code>weak_pointer</code>

1965

will be set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1965

will be set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1966

Note that as with <a class="link" href="gobject-The-Base-Object-Type.html#g-object-weak-ref" title="g_object_weak_ref ()"><code class="function">g_object_weak_ref()</code></a>, the weak references created by

1967

this method are not thread-safe: they cannot safely be used in one

1968

thread if the object's last <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()"><code class="function">g_object_unref()</code></a> might happen in another

1995

<a name="g-object-remove-weak-pointer"></a><h3>g_object_remove_weak_pointer ()</h3>

1996

<pre class="programlisting">void

1997

g_object_remove_weak_pointer (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

1998

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> *weak_pointer_location</code>);</pre>

1998

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

1999

Removes a weak reference from <code>object</code>

2000

that was previously added

2001

using <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-weak-pointer" title="g_object_add_weak_pointer ()"><code class="function">g_object_add_weak_pointer()</code></a>. The <code>weak_pointer_location</code>

2028

2029

<a name="GToggleNotify"></a><h3>GToggleNotify ()</h3>

2030

<pre class="programlisting">void

2031

(*GToggleNotify) (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

2031

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

2032

<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2033

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> is_last_ref</code>);</pre>

2033

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

2034

A callback function used for notification when the state

2035

of a toggle reference changes. See <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-toggle-ref" title="g_object_add_toggle_ref ()"><code class="function">g_object_add_toggle_ref()</code></a>.

2036

2054

</tr>

2055

<tr>

2056

2057

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the toggle reference is now the

2058

last reference to the object. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the toggle

2057

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the toggle reference is now the

2058

last reference to the object. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the toggle

2059

reference was the last reference and there are now other

2060

references.</td>

2061

2070

<pre class="programlisting">void

2071

g_object_add_toggle_ref (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2072

<code><a class="link" href="gobject-The-Base-Object-Type.html#GToggleNotify" title="GToggleNotify ()">GToggleNotify</a> notify</code>,

2073

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

2073

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

2074

Increases the reference count of the object by one and sets a

2075

callback to be called when all other references to the object are

2076

dropped, or when this is already the last reference to the object

2141

<pre class="programlisting">void

2142

g_object_remove_toggle_ref (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2143

<code><a class="link" href="gobject-The-Base-Object-Type.html#GToggleNotify" title="GToggleNotify ()">GToggleNotify</a> notify</code>,

2144

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

2144

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

2145

Removes a reference added with <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-toggle-ref" title="g_object_add_toggle_ref ()"><code class="function">g_object_add_toggle_ref()</code></a>. The

2146

reference count of the object is decreased by one.

2147

2179

<hr>

2180

2181

<a name="g-object-connect"></a><h3>g_object_connect ()</h3>

2182

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

2183

g_object_connect (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

2184

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *signal_spec</code>,

2182

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

2183

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

2184

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

2185

2186

A convenience function to connect multiple signals at once.

2187

The signal specs expected by this function have the form

2245

2246

<td class="parameter_description"><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> for the first signal, followed by data for the

2247

first signal, followed optionally by more signal

2248

spec/callback/data triples, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2248

spec/callback/data triples, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2249

2250

</tr>

2251

</tbody>

2262

2263

<a name="g-object-disconnect"></a><h3>g_object_disconnect ()</h3>

2264

<pre class="programlisting">void

2265

g_object_disconnect (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

2266

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *signal_spec</code>,

2265

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

2266

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

2267

2268

A convenience function to disconnect multiple signals at once.

2269

The signal specs expected by this function have the form

2293

2294

<td class="parameter_description"><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> for the first signal, followed by data for the first signal,

2295

followed optionally by more signal spec/callback/data triples,

2296

followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2296

followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2297

2298

</tr>

2299

</tbody>

2304

2305

<a name="g-object-set"></a><h3>g_object_set ()</h3>

2306

<pre class="programlisting">void

2307

g_object_set (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

2308

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

2307

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

2308

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

2309

2310

Sets properties on an object.

2311

Note that the "notify" signals are queued and only emitted (in

2333

<tr>

2334

2335

<td class="parameter_description">value for the first property, followed optionally by more

2336

name/value pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2336

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

2337

2338

</tr>

2339

</tbody>

2344

2345

<a name="g-object-get"></a><h3>g_object_get ()</h3>

2346

<pre class="programlisting">void

2347

g_object_get (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

2348

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

2347

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

2348

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

2349

2350

Gets properties of an object.

2351

In general, a copy is made of the property contents and the caller

2352

is responsible for freeing the memory in the appropriate manner for

2353

the type, for instance by calling <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> or <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()"><code class="function">g_object_unref()</code></a>.

2353

the type, for instance by calling <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> or <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()"><code class="function">g_object_unref()</code></a>.

2354

Here is an example of using <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get" title="g_object_get ()"><code class="function">g_object_get()</code></a> to get the contents

2355

of three properties: an integer, a string and an object:

2356

2383

2384

// Do something with intval, strval, objval

2385

2386

<a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a> (strval);

2386

<a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a> (strval);

2387

<a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (objval);</pre></td>

2388

</tr>

2389

</tbody>

2413

<tr>

2414

2415

<td class="parameter_description">return location for the first property, followed optionally by more

2416

name/return location pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2416

name/return location pairs, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2417

2418

</tr>

2419

</tbody>

2425

<a name="g-object-notify"></a><h3>g_object_notify ()</h3>

2426

<pre class="programlisting">void

2427

g_object_notify (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2428

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *property_name</code>);</pre>

2428

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

2429

Emits a "notify" signal for the property <code>property_name</code>

2430

on <code>object</code>

2431

.

2626

<hr>

2627

2628

<a name="g-object-get-data"></a><h3>g_object_get_data ()</h3>

2629

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

2629

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

2630

g_object_get_data (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2631

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>);</pre>

2631

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

2632

Gets a named field from the objects table of associations (see <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-data" title="g_object_set_data ()"><code class="function">g_object_set_data()</code></a>).

2633

2634

<a name="id-1.4.5.10.47.5"></a><h4>Parameters</h4>

2654

</div>

2655

2656

<a name="id-1.4.5.10.47.6"></a><h4>Returns</h4>

2657

the data if found, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.

2657

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.

2658

[<acronym title="Don't free data after the code is done.">transfer none</acronym>]

2659

</div>

2660

</div>

2663

<a name="g-object-set-data"></a><h3>g_object_set_data ()</h3>

2664

<pre class="programlisting">void

2665

g_object_set_data (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2666

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

2667

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

2666

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

2667

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

2668

Each object carries around a table of associations from

2669

strings to pointers. This function lets you set an association.

2670

If the object already had an association with that name,

2702

<a name="g-object-set-data-full"></a><h3>g_object_set_data_full ()</h3>

2703

<pre class="programlisting">void

2704

g_object_set_data_full (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2705

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

2706

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

2707

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

2705

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

2706

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

2707

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

2708

Like <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-data" title="g_object_set_data ()"><code class="function">g_object_set_data()</code></a> except it adds notification

2709

for when the association is destroyed, either by setting it

2710

to a different value or when the object is destroyed.

2711

Note that the <code>destroy</code>

2712

callback is not called if <code>data</code>

2713

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2713

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2714

2715

<a name="id-1.4.5.10.49.6"></a><h4>Parameters</h4>

2716

2747

<hr>

2748

2749

<a name="g-object-steal-data"></a><h3>g_object_steal_data ()</h3>

2750

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

2750

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

2751

g_object_steal_data (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2752

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>);</pre>

2752

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

2753

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

2754

without invoking the association's destroy handler.

2755

2776

</div>

2777

2778

<a name="id-1.4.5.10.50.6"></a><h4>Returns</h4>

2779

the data if found, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists.

2779

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.

2780

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2781

</div>

2782

</div>

2783

<hr>

2784

2785

<a name="g-object-dup-data"></a><h3>g_object_dup_data ()</h3>

2786

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

2786

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

2787

g_object_dup_data (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2788

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

2789

<code><a href="../glib/glib-Keyed-Data-Lists.html#GDuplicateFunc">GDuplicateFunc</a> dup_func</code>,

2790

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2788

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

2789

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Keyed-Data-Lists.html#GDuplicateFunc">GDuplicateFunc</a> dup_func</code>,

2790

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

2791

This is a variant of <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-data" title="g_object_get_data ()"><code class="function">g_object_get_data()</code></a> which returns

2792

a 'duplicate' of the value. <code>dup_func</code>

2793

defines the

2796

If the <code>key</code>

2797

is not set on the object then <code>dup_func</code>

2798

2799

will be called with a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> argument.

2799

will be called with a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> argument.

2800

Note that <code>dup_func</code>

2801

is called while user data of <code>object</code>

2802

2843

on the value

2844

associated with <code>key</code>

2845

on <code>object</code>

2846

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not set.

2846

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not set.

2847

If <code>dup_func</code>

2848

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the value is returned

2848

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the value is returned

2849

unmodified.

2850

2851

</div>

2854

<hr>

2855

2856

<a name="g-object-replace-data"></a><h3>g_object_replace_data ()</h3>

2857

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

2857

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

2858

g_object_replace_data (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2859

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

2860

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> oldval</code>,

2861

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> newval</code>,

2862

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

2863

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> *old_destroy</code>);</pre>

2859

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

2860

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

2861

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

2862

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

2863

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

2864

Compares the user data for the key <code>key</code>

2865

on <code>object</code>

2866

with

2880

or may not include using <code>old_destroy</code>

2881

as sometimes replacement

2882

should not destroy the object in the normal way.

2883

Return: <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the existing value for <code>key</code>

2883

Return: <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the existing value for <code>key</code>

2884

was replaced

2885

by <code>newval</code>

2886

, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

2886

, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

2887

2888

<a name="id-1.4.5.10.52.8"></a><h4>Parameters</h4>

2889

2931

<hr>

2932

2933

<a name="g-object-get-qdata"></a><h3>g_object_get_qdata ()</h3>

2934

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

2934

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

2935

g_object_get_qdata (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2936

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> quark</code>);</pre>

2936

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

2937

This function gets back user data pointers stored via

2938

<a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-qdata" title="g_object_set_qdata ()"><code class="function">g_object_set_qdata()</code></a>.

2939

2952

</tr>

2953

<tr>

2954

<td class="parameter_name">quark</td>

2955

<td class="parameter_description">A <a href="../glib/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

2955

<td class="parameter_description">A <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

2956

2957

</tr>

2958

</tbody>

2960

</div>

2961

2962

<a name="id-1.4.5.10.53.6"></a><h4>Returns</h4>

2963

The user data pointer set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2963

The user data pointer set, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2964

[<acronym title="Don't free data after the code is done.">transfer none</acronym>]

2965

</div>

2966

</div>

2969

<a name="g-object-set-qdata"></a><h3>g_object_set_qdata ()</h3>

2970

<pre class="programlisting">void

2971

g_object_set_qdata (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

2972

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> quark</code>,

2973

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

2972

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

2973

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

2974

This sets an opaque, named pointer on an object.

2975

The name is specified through a <a href="../glib/glib-Quarks.html#GQuark">GQuark</a> (retrived e.g. via

2976

<a href="../glib/glib-Quarks.html#g-quark-from-static-string"><code class="function">g_quark_from_static_string()</code></a>), and the pointer

2975

The name is specified through a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> (retrived e.g. via

2976

<a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-quark-from-static-string"><code class="function">g_quark_from_static_string()</code></a>), and the pointer

2977

can be gotten back from the <code>object</code>

2978

with <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-qdata" title="g_object_get_qdata ()"><code class="function">g_object_get_qdata()</code></a>

2979

until the <code>object</code>

2980

is finalized.

2981

Setting a previously set user data pointer, overrides (frees)

2982

the old pointer set, using <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a> as pointer essentially

2982

the old pointer set, using <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a> as pointer essentially

2983

removes the data stored.

2984

2985

<a name="id-1.4.5.10.54.5"></a><h4>Parameters</h4>

2997

</tr>

2998

<tr>

2999

<td class="parameter_name">quark</td>

3000

<td class="parameter_description">A <a href="../glib/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3000

<td class="parameter_description">A <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3001

3002

</tr>

3003

<tr>

3014

<a name="g-object-set-qdata-full"></a><h3>g_object_set_qdata_full ()</h3>

3015

<pre class="programlisting">void

3016

g_object_set_qdata_full (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3017

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> quark</code>,

3018

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

3019

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

3017

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

3018

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

3019

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

3020

This function works like <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-qdata" title="g_object_set_qdata ()"><code class="function">g_object_set_qdata()</code></a>, but in addition,

3021

a void (*destroy) (gpointer) function may be specified which is

3022

called with <code>data</code>

3041

</tr>

3042

<tr>

3043

<td class="parameter_name">quark</td>

3044

<td class="parameter_description">A <a href="../glib/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3044

<td class="parameter_description">A <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3045

3046

</tr>

3047

<tr>

3063

<hr>

3064

3065

<a name="g-object-steal-qdata"></a><h3>g_object_steal_qdata ()</h3>

3066

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

3066

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

3067

g_object_steal_qdata (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3068

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> quark</code>);</pre>

3068

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

3069

This function gets back user data pointers stored via

3070

<a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-qdata" title="g_object_set_qdata ()"><code class="function">g_object_set_qdata()</code></a> and removes the <code>data</code>

3071

from object

3105

const gchar *new_string)

3106

{

3107

// the quark, naming the object data

3108

GQuark quark_string_list = <a href="../glib/glib-Quarks.html#g-quark-from-static-string">g_quark_from_static_string</a> ("my-string-list");

3108

GQuark quark_string_list = <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-quark-from-static-string">g_quark_from_static_string</a> ("my-string-list");

3109

// retrive the old string list

3110

GList *list = <a href="gobject-The-Base-Object-Type.html#g-object-steal-qdata">g_object_steal_qdata</a> (object, quark_string_list);

3111

3112

// prepend new string

3113

list = <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a> (list, <a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a> (new_string));

3113

list = <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a> (list, <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strdup">g_strdup</a> (new_string));

3114

// this changed 'list', so we need to set it again

3115

<a href="gobject-The-Base-Object-Type.html#g-object-set-qdata-full">g_object_set_qdata_full</a> (object, quark_string_list, list, free_string_list);

3116

}

3120

GList *node, *list = data;

3121

3122

for (node = list; node; node = node->next)

3123

<a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a> (node->data);

3124

<a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a> (list);

3123

3124

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a> (list);

3125

}</pre></td>

3126

</tr>

3127

</tbody>

3149

</tr>

3150

<tr>

3151

<td class="parameter_name">quark</td>

3152

<td class="parameter_description">A <a href="../glib/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3152

<td class="parameter_description">A <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3153

3154

</tr>

3155

</tbody>

3157

</div>

3158

3159

<a name="id-1.4.5.10.56.8"></a><h4>Returns</h4>

3160

The user data pointer set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

3160

The user data pointer set, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

3161

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3162

</div>

3163

</div>

3164

<hr>

3165

3166

<a name="g-object-dup-qdata"></a><h3>g_object_dup_qdata ()</h3>

3167

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

3167

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

3168

g_object_dup_qdata (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3169

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> quark</code>,

3170

<code><a href="../glib/glib-Keyed-Data-Lists.html#GDuplicateFunc">GDuplicateFunc</a> dup_func</code>,

3171

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3169

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

3170

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Keyed-Data-Lists.html#GDuplicateFunc">GDuplicateFunc</a> dup_func</code>,

3171

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

3172

This is a variant of <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-qdata" title="g_object_get_qdata ()"><code class="function">g_object_get_qdata()</code></a> which returns

3173

a 'duplicate' of the value. <code>dup_func</code>

3174

defines the

3177

If the <code>quark</code>

3178

is not set on the object then <code>dup_func</code>

3179

3180

will be called with a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> argument.

3180

will be called with a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> argument.

3181

Note that <code>dup_func</code>

3182

is called while user data of <code>object</code>

3183

3201

</tr>

3202

<tr>

3203

<td class="parameter_name">quark</td>

3204

<td class="parameter_description">a <a href="../glib/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3204

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3205

3206

</tr>

3207

<tr>

3224

on the value

3225

associated with <code>quark</code>

3226

on <code>object</code>

3227

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not set.

3227

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not set.

3228

If <code>dup_func</code>

3229

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the value is returned

3229

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the value is returned

3230

unmodified.

3231

3232

</div>

3235

<hr>

3236

3237

<a name="g-object-replace-qdata"></a><h3>g_object_replace_qdata ()</h3>

3238

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

3238

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

3239

g_object_replace_qdata (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3240

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> quark</code>,

3241

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> oldval</code>,

3242

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> newval</code>,

3243

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

3244

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> *old_destroy</code>);</pre>

3240

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

3241

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

3242

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

3243

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

3244

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

3245

Compares the user data for the key <code>quark</code>

3246

on <code>object</code>

3247

with

3261

or may not include using <code>old_destroy</code>

3262

as sometimes replacement

3263

should not destroy the object in the normal way.

3264

Return: <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the existing value for <code>quark</code>

3264

3265

was replaced

3266

by <code>newval</code>

3267

, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

3267

, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

3268

3269

<a name="id-1.4.5.10.58.8"></a><h4>Parameters</h4>

3270

3281

</tr>

3282

<tr>

3283

<td class="parameter_name">quark</td>

3284

<td class="parameter_description">a <a href="../glib/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3284

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a>, naming the user data pointer</td>

3285

3286

</tr>

3287

<tr>

3314

<a name="g-object-set-property"></a><h3>g_object_set_property ()</h3>

3315

<pre class="programlisting">void

3316

g_object_set_property (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3317

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *property_name</code>,

3317

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

3318

<code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value</code>);</pre>

3319

Sets a property on an object.

3320

3350

<a name="g-object-get-property"></a><h3>g_object_get_property ()</h3>

3351

<pre class="programlisting">void

3352

g_object_get_property (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3353

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *property_name</code>,

3353

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

3354

<code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value</code>);</pre>

3355

Gets a property of an object. <code>value</code>

3356

must have been initialized to the

3393

<a name="g-object-new-valist"></a><h3>g_object_new_valist ()</h3>

3394

<pre class="programlisting"><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *

3395

g_object_new_valist (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

3396

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

3396

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

3397

3398

Creates a new instance of a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> subtype and sets its properties.

3399

3420

<tr>

3421

3422

<td class="parameter_description">the value of the first property, followed optionally by more

3423

name/value pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

3423

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

3424

3425

</tr>

3426

</tbody>

3438

<a name="g-object-set-valist"></a><h3>g_object_set_valist ()</h3>

3439

<pre class="programlisting">void

3440

g_object_set_valist (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3441

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

3441

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

3442

3443

Sets properties on an object.

3444

3463

<tr>

3464

3465

<td class="parameter_description">value for the first property, followed optionally by more

3466

name/value pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

3466

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

3467

3468

</tr>

3469

</tbody>

3475

<a name="g-object-get-valist"></a><h3>g_object_get_valist ()</h3>

3476

<pre class="programlisting">void

3477

g_object_get_valist (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

3478

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *first_property_name</code>,

3478

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

3479

3480

Gets properties of an object.

3481

In general, a copy is made of the property contents and the caller

3482

is responsible for freeing the memory in the appropriate manner for

3483

3484

See <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get" title="g_object_get ()"><code class="function">g_object_get()</code></a>.

3485

3486

<a name="id-1.4.5.10.63.7"></a><h4>Parameters</h4>

3504

<tr>

3505

3506

<td class="parameter_description">return location for the first property, followed optionally by more

3507

name/return location pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

3507

name/return location pairs, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

3508

3509

</tr>

3510

</tbody>

3619

3620

<pre class="programlisting">void

3621

g_weak_ref_init (<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> *weak_ref</code>,

3622

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);</pre>

3622

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

3623

Initialise a non-statically-allocated <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a>.

3624

This function also calls <a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-set" title="g_weak_ref_set ()"><code class="function">g_weak_ref_set()</code></a> with <code>object</code>

3625

on the

3645

</tr>

3646

<tr>

3647

<td class="parameter_name">object</td>

3648

<td class="parameter_description"> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

3648

<td class="parameter_description"> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

3649

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3650

</tr>

3651

</tbody>

3683

<hr>

3684

3685

3686

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>

3686

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

3687

g_weak_ref_get (<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> *weak_ref</code>);</pre>

3688

If <code>weak_ref</code>

3689

is not empty, atomically acquire a strong

3712

<a name="id-1.4.5.10.69.8"></a><h4>Returns</h4>

3713

the object pointed to

3714

by <code>weak_ref</code>

3715

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it was empty.

3715

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it was empty.

3716

[<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="Override the parsed C type with given type.">type</acronym> GObject.Object]

3717

</div>

3718

Since 2.32

3722

3723

<pre class="programlisting">void

3724

g_weak_ref_set (<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> *weak_ref</code>,

3725

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);</pre>

3725

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

3726

Change the object to which <code>weak_ref</code>

3727

points, or set it to

3728

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

3728

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

3729

You must own a strong reference on <code>object</code>

3730

while calling this

3731

function.

3745

</tr>

3746

<tr>

3747

<td class="parameter_name">object</td>

3748

3749

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3750

</tr>

3751

</tbody>

3968

</colgroup>

3969

<tbody>

3970

<tr>

3971

<td class="struct_member_name">const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GParameter.name"></a>name</code>;</td>

3971

<td class="struct_member_name">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GParameter.name"></a>name</code>;</td>

3972

<td class="struct_member_description">the parameter name</td>

3973

3974

</tr>

4011

} GWeakRef;

4012

</pre>

4013

A structure containing a weak reference to a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a>. It can either

4014

be empty (i.e. point to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), or point to an object for as long as

4014

be empty (i.e. point to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), or point to an object for as long as

4015

at least one "strong" reference to that object exists. Before the

4016

object's <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass.dispose">GObjectClass.dispose</a> method is called, every <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a>

4017

associated with becomes empty (i.e. points to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).

4017

associated with becomes empty (i.e. points to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).

4018

Like <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a>, <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> can be statically allocated, stack- or

4019

heap-allocated, or embedded in larger structures.

4020

Unlike <a class="link" href="gobject-The-Base-Object-Type.html#g-object-weak-ref" title="g_object_weak_ref ()"><code class="function">g_object_weak_ref()</code></a> and <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-weak-pointer" title="g_object_add_weak_pointer ()"><code class="function">g_object_add_weak_pointer()</code></a>, this weak

4023

objects.

4024

If the object's <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass.dispose">GObjectClass.dispose</a> method results in additional

4025

references to the object being held, any <a href="gobject-The-Base-Object-Type.html#GWeakRef">GWeakRefs</a> taken

4026

before it was disposed will continue to point to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If

4026

before it was disposed will continue to point to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If

4027

<a href="gobject-The-Base-Object-Type.html#GWeakRef">GWeakRefs</a> are taken after the object is disposed and

4028

re-referenced, they will continue to point to it until its refcount

4029

goes back to zero, at which point they too will be invalidated.

4036

<pre class="programlisting">void

4037

user_function (<a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *gobject,

4038

<a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> *pspec,

4039

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data)</pre>

4039

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

4040

The notify signal is emitted on an object when one of its

4041

properties has been changed. Note that getting this signal

4042

doesn't guarantee that the value of the property has actually

Older »