~ubuntu-branches/debian/sid/glib2.0/sid

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

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

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

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

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

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

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

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

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

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

void (<a class="link" href="gobject-The-Base-Object-Type.html#GObjectFinalizeFunc" title="GObjectFinalizeFunc ()">*GObjectFinalizeFunc</a>) (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>);

#define <a class="link" href="gobject-The-Base-Object-Type.html#G-OBJECT-CLASS-TYPE:CAPS" title="G_OBJECT_CLASS_TYPE()">G_OBJECT_CLASS_TYPE</a> (class)

#define <a class="link" href="gobject-The-Base-Object-Type.html#G-OBJECT-CLASS-NAME:CAPS" title="G_OBJECT_CLASS_NAME()">G_OBJECT_CLASS_NAME</a> (class)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-install-property" title="g_object_interface_install_property ()">g_object_interface_install_property</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

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

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

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-install-property" title="g_object_interface_install_property ()">g_object_interface_install_property</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

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

<a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> * <a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-find-property" title="g_object_interface_find_property ()">g_object_interface_find_property</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

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

<a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> ** <a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-list-properties" title="g_object_interface_list_properties ()">g_object_interface_list_properties</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

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

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-new" title="g_object_new ()">g_object_new</a> (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

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

<a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> * <a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-find-property" title="g_object_interface_find_property ()">g_object_interface_find_property</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

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

<a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> ** <a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-list-properties" title="g_object_interface_list_properties ()">g_object_interface_list_properties</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

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

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-new" title="g_object_new ()">g_object_new</a> (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

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

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

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-newv" title="g_object_newv ()">g_object_newv</a> (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

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

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-newv" title="g_object_newv ()">g_object_newv</a> (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

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

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

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

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref" title="g_object_ref ()">g_object_ref</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()">g_object_unref</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref-sink" title="g_object_ref_sink ()">g_object_ref_sink</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref" title="g_object_ref ()">g_object_ref</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()">g_object_unref</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref-sink" title="g_object_ref_sink ()">g_object_ref_sink</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

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

typedef <a class="link" href="gobject-The-Base-Object-Type.html#GInitiallyUnowned" title="GInitiallyUnowned">GInitiallyUnowned</a>;

100

typedef <a class="link" href="gobject-The-Base-Object-Type.html#GInitiallyUnownedClass" title="GInitiallyUnownedClass">GInitiallyUnownedClass</a>;

101

#define <a class="link" href="gobject-The-Base-Object-Type.html#G-TYPE-INITIALLY-UNOWNED:CAPS" title="G_TYPE_INITIALLY_UNOWNED">G_TYPE_INITIALLY_UNOWNED</a>

102

<a href="./../glib/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-is-floating" title="g_object_is_floating ()">g_object_is_floating</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

102

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-is-floating" title="g_object_is_floating ()">g_object_is_floating</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>);

103

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-force-floating" title="g_object_force_floating ()">g_object_force_floating</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>);

104

void (<a class="link" href="gobject-The-Base-Object-Type.html#GWeakNotify" title="GWeakNotify ()">*GWeakNotify</a>) (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

104

void (<a class="link" href="gobject-The-Base-Object-Type.html#GWeakNotify" title="GWeakNotify ()">*GWeakNotify</a>) (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

105

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

106

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

107

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

108

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

108

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

109

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

110

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

111

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

111

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

112

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

113

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

113

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

114

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-remove-weak-pointer" title="g_object_remove_weak_pointer ()">g_object_remove_weak_pointer</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

115

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

116

void (<a class="link" href="gobject-The-Base-Object-Type.html#GToggleNotify" title="GToggleNotify ()">*GToggleNotify</a>) (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

115

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

116

void (<a class="link" href="gobject-The-Base-Object-Type.html#GToggleNotify" title="GToggleNotify ()">*GToggleNotify</a>) (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

117

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

118

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

118

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

119

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-toggle-ref" title="g_object_add_toggle_ref ()">g_object_add_toggle_ref</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

120

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

121

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

121

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

122

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-remove-toggle-ref" title="g_object_remove_toggle_ref ()">g_object_remove_toggle_ref</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

123

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

124

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

125

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-connect" title="g_object_connect ()">g_object_connect</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

126

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

127

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

128

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-disconnect" title="g_object_disconnect ()">g_object_disconnect</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

129

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

130

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

131

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set" title="g_object_set ()">g_object_set</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

132

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

133

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

134

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get" title="g_object_get ()">g_object_get</a> (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

135

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

124

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

125

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-connect" title="g_object_connect ()">g_object_connect</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

126

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

127

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

128

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-disconnect" title="g_object_disconnect ()">g_object_disconnect</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

129

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

130

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

131

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set" title="g_object_set ()">g_object_set</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

132

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

133

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

134

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get" title="g_object_get ()">g_object_get</a> (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> object</code>,

135

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

136

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

137

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

138

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

138

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

139

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec" title="g_object_notify_by_pspec ()">g_object_notify_by_pspec</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

140

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

141

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-freeze-notify" title="g_object_freeze_notify ()">g_object_freeze_notify</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>);

142

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-thaw-notify" title="g_object_thaw_notify ()">g_object_thaw_notify</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>);

143

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-data" title="g_object_get_data ()">g_object_get_data</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

144

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

143

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-data" title="g_object_get_data ()">g_object_get_data</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

144

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

145

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

146

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

147

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

146

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

147

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

148

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-data-full" title="g_object_set_data_full ()">g_object_set_data_full</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

149

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

150

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

151

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

152

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-steal-data" title="g_object_steal_data ()">g_object_steal_data</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

153

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

154

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-qdata" title="g_object_get_qdata ()">g_object_get_qdata</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

155

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

149

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

150

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

151

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

152

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-steal-data" title="g_object_steal_data ()">g_object_steal_data</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

153

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

154

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-dup-data" title="g_object_dup_data ()">g_object_dup_data</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

155

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

156

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

157

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

158

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-replace-data" title="g_object_replace_data ()">g_object_replace_data</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

159

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

160

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

161

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

162

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

163

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

164

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-qdata" title="g_object_get_qdata ()">g_object_get_qdata</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

165

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

156

166

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

157

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

158

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

167

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

168

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

159

169

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-qdata-full" title="g_object_set_qdata_full ()">g_object_set_qdata_full</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

160

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

161

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

162

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

163

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-steal-qdata" title="g_object_steal_qdata ()">g_object_steal_qdata</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

164

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

170

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

171

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

172

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

173

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-steal-qdata" title="g_object_steal_qdata ()">g_object_steal_qdata</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

174

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

175

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-dup-qdata" title="g_object_dup_qdata ()">g_object_dup_qdata</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

176

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

177

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

178

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

179

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-object-replace-qdata" title="g_object_replace_qdata ()">g_object_replace_qdata</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

180

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

181

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

182

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

183

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

184

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

165

185

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

166

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

186

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

167

187

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

168

188

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

169

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

189

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

170

190

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

171

191

<a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> * <a class="link" href="gobject-The-Base-Object-Type.html#g-object-new-valist" title="g_object_new_valist ()">g_object_new_valist</a> (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

172

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

192

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

173

193

<code>va_list var_args</code>);

174

194

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

175

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

195

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

176

196

<code>va_list var_args</code>);

177

197

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

178

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

198

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

179

199

<code>va_list var_args</code>);

180

200

void <a class="link" href="gobject-The-Base-Object-Type.html#g-object-watch-closure" title="g_object_watch_closure ()">g_object_watch_closure</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

181

201

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *closure</code>);

186

206

187

207

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

188

208

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

189

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

209

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

190

210

void <a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-clear" title="g_weak_ref_clear ()">g_weak_ref_clear</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> *weak_ref</code>);

191

<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-get" title="g_weak_ref_get ()">g_weak_ref_get</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> *weak_ref</code>);

211

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-get" title="g_weak_ref_get ()">g_weak_ref_get</a> (<code><a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> *weak_ref</code>);

192

212

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

193

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

213

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

194

214

</pre>

195

215

</div>

196

216

297

317

298

318

299

319

300

9</pre></td>

320

321

10</pre></td>

301

322

<td class="listing_code"><pre class="programlisting">/* save floating state */

302

323

gboolean was_floating = <a href="gobject-The-Base-Object-Type.html#g-object-is-floating">g_object_is_floating</a> (object);

303

324

<a href="gobject-The-Base-Object-Type.html#g-object-ref-sink">g_object_ref_sink</a> (object);

306

327

/* restore floating state */

307

328

if (was_floating)

308

329

<a href="gobject-The-Base-Object-Type.html#g-object-force-floating">g_object_force_floating</a> (object);

309

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

330

else

331

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

310

332

</tr>

311

333

</tbody>

312

334

</table>

364

386

365

387

366

388

367

<a name="id587132"></a>Example 1. Implementing singletons using a constructor

389

<a name="id-1.4.5.7.3.5.1"></a>Example 1. Implementing singletons using a constructor

368

390

369

391

370

392

<tbody>

390

412

391

413

392

414

21</pre></td>

393

<td class="listing_code"><pre class="programlisting">static MySingleton *the_singleton = <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>;

415

<td class="listing_code"><pre class="programlisting">static MySingleton *the_singleton = <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>;

394

416

395

417

static <a href="gobject-The-Base-Object-Type.html#GObject">GObject</a>*

396

418

my_singleton_constructor (GType type,

440

462

<tr>

441

463

<td><code><a name="GObjectClass.set-property"></a>set_property</code> ()</td>

442

464

<td>the generic setter for all properties of this type. Should be

443

overridden for every type with properties. Implementations of <code>set_property</code>

444

don't need to emit property change notification explicitly, this is handled

445

by the type system.</td>

465

overridden for every type with properties. If implementations of

466

<code>set_property</code> don't emit property change notification explicitly, this will

467

be done implicitly by the type system. However, if the notify signal is

468

emitted explicitly, the type system will not emit it a second time.</td>

446

469

</tr>

447

470

<tr>

448

471

<td><code><a name="GObjectClass.get-property"></a>get_property</code> ()</td>

520

543

521

544

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

522

545

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

523

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

546

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

524

547

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

525

548

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

526

549

557

580

558

581

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

559

582

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

560

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

583

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

561

584

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

562

585

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

563

586

629

652

<tr>

630

653

<td>Returns :</td>

631

654

<td>

632

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

655

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

633

656

</tr>

634

657

</tbody>

635

658

</table></div>

848

871

849

872

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

850

873

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

851

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

874

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

852

875

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

853

876

854

877

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

884

907

885

908

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

886

909

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

887

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

910

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

888

911

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

889

912

890

913

Installs new properties from an array of <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a>s. This is

941

964

PROP_0, PROP_FOO, PROP_BAR, N_PROPERTIES

942

965

};

943

966

944

static GParamSpec *obj_properties[N_PROPERTIES] = { <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, };

967

static GParamSpec *obj_properties[N_PROPERTIES] = { <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, };

945

968

946

969

static void

947

970

my_object_class_init (MyObjectClass *klass)

950

973

951

974

obj_properties[PROP_FOO] =

952

975

<a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-int">g_param_spec_int</a> ("foo", "Foo", "Foo",

953

-1, <a href="./../glib/glib/glib-Basic-Types.html#G-MAXINT:CAPS">G_MAXINT</a>,

976

-1, <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS">G_MAXINT</a>,

954

977

0,

955

978

<a href="gobject-GParamSpec.html#G-PARAM-READWRITE:CAPS">G_PARAM_READWRITE</a>);

956

979

957

980

obj_properties[PROP_BAR] =

958

981

<a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-string">g_param_spec_string</a> ("bar", "Bar", "Bar",

959

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

982

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

960

983

<a href="gobject-GParamSpec.html#G-PARAM-READWRITE:CAPS">G_PARAM_READWRITE</a>);

961

984

962

985

gobject_class->set_property = my_object_set_property;

1035

1058

1036

1059

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

1037

1060

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

1038

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

1061

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

1039

1062

1040

1063

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

1041

1064

1057

1080

<tr>

1058

1081

<td>Returns :</td>

1059

1082

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

1060

<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the class doesn't have a property of that name. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1083

<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. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1061

1084

</td>

1062

1085

</tr>

1063

1086

</tbody>

1067

1090

1068

1091

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

1069

1092

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

1070

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

1093

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

1071

1094

1072

1095

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

1073

1096

1100

1123

1101

1124

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

1102

1125

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

1103

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

1104

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

1126

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

1127

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

1105

1128

1106

1129

Registers <code>property_id</code> as referring to a property with the

1107

1130

name <code>name</code> in a parent class or in an interface implemented

1153

1176

<hr>

1154

1177

1155

1178

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

1156

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

1179

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

1157

1180

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

1158

1181

1159

1182

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

1194

1217

<hr>

1195

1218

1196

1219

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

1197

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> * g_object_interface_find_property (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

1198

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

1220

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> * g_object_interface_find_property (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

1221

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

1199

1222

1200

1223

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

1201

1224

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

1221

1244

<tr>

1222

1245

<td>Returns :</td>

1223

1246

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

1224

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

1247

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

1225

1248

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

1226

1249

</td>

1227

1250

</tr>

1232

1255

<hr>

1233

1256

1234

1257

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

1235

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> ** g_object_interface_list_properties (<code><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

1236

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

1258

<pre class="programlisting"><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a> ** g_object_interface_list_properties (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_iface</code>,

1259

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

1237

1260

1238

1261

Lists the properties of an interface.Generally, the interface

1239

1262

vtable passed in as <code>g_iface</code> will be the default vtable from

1261

1284

<td>a

1262

1285

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

1263

1286

structures. The paramspecs are owned by GLib, but the

1264

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

1287

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

1265

1288

it. [<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>]

1266

1289

</td>

1267

1290

</tr>

1272

1295

<hr>

1273

1296

1274

1297

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

1275

<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> g_object_new (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

1276

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

1298

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_object_new (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

1299

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

1277

1300

1278

1301

1279

1302

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

1299

1322

<tr>

1300

1323

1301

1324

<td>the value of the first property, followed optionally by more

1302

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

1325

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

1303

1326

</td>

1304

1327

</tr>

1305

1328

<tr>

1313

1336

<hr>

1314

1337

1315

1338

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

1316

<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> g_object_newv (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

1317

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

1339

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> g_object_newv (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

1340

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

1318

1341

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

1319

1342

1320

1343

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

1348

1371

<tr>

1349

1372

<td>Returns :</td>

1350

1373

<td>a new instance of

1351

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

1374

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

1352

1375

</td>

1353

1376

</tr>

1354

1377

</tbody>

1373

1396

</colgroup>

1374

1397

<tbody>

1375

1398

<tr>

1376

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

1399

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

1377

1400

<td>the parameter name</td>

1378

1401

</tr>

1379

1402

<tr>

1386

1409

<hr>

1387

1410

1388

1411

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

1389

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

1412

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

1390

1413

1391

1414

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

1392

1415

1398

1421

<tbody>

1399

1422

<tr>

1400

1423

<td><code>object</code> :</td>

1401

<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a>. [<acronym title="Override the parsed C type with given type">type</acronym> GObject.Object]

1424

<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a>. [<acronym title="Override the parsed C type with given type.">type</acronym> GObject.Object]

1402

1425

</td>

1403

1426

</tr>

1404

1427

<tr>

1405

1428

<td>Returns :</td>

1406

<td>the same <code>object</code>. [<acronym title="Override the parsed C type with given type">type</acronym> GObject.Object][<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1429

<td>the same <code>object</code>. [<acronym title="Override the parsed C type with given type.">type</acronym> GObject.Object][<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1407

1430

</td>

1408

1431

</tr>

1409

1432

</tbody>

1412

1435

<hr>

1413

1436

1414

1437

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

1415

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

1438

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

1416

1439

1417

1440

Decreases the reference count of <code>object</code>. When its reference count

1418

1441

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

1424

1447

</colgroup>

1425

1448

1426

1449

<td><code>object</code> :</td>

1427

1450

<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a>. [<acronym title="Override the parsed C type with given type.">type</acronym> GObject.Object]

1428

1451

</td>

1429

1452

</tr></tbody>

1430

1453

</table></div>

1432

1455

<hr>

1433

1456

1434

1457

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

1435

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

1458

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

1436

1459

1437

1460

Increase the reference count of <code>object</code>, and possibly remove the

1438

1461

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

1453

1476

<tbody>

1454

1477

<tr>

1455

1478

<td><code>object</code> :</td>

1456

1479

<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a>. [<acronym title="Override the parsed C type with given type.">type</acronym> GObject.Object]

1457

1480

</td>

1458

1481

</tr>

1459

1482

<tr>

1460

1483

<td>Returns :</td>

1461

1484

<td>

1462

<code>object</code>. [<acronym title="Override the parsed C type with given type">type</acronym> GObject.Object][<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1485

<code>object</code>. [<acronym title="Override the parsed C type with given type.">type</acronym> GObject.Object][<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1463

1486

</td>

1464

1487

</tr>

1465

1488

</tbody>

1474

1497

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

1475

1498

1476

1499

1477

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

1500

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

1478

1501

1479

1502

1480

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

1503

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

1481

1504

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

1482

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

1505

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

1483

1506

1484

1507

1485

1508

This function is threadsafe and modifies the pointer atomically,

1533

1556

<hr>

1534

1557

1535

1558

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

1536

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

1559

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

1537

1560

1538

1561

Checks whether <code>object</code> has a <a class="link" href="gobject-The-Base-Object-Type.html#floating-ref">floating</a>

1539

1562

reference.

1546

1569

<tbody>

1547

1570

<tr>

1548

1571

<td><code>object</code> :</td>

1549

1572

<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a>. [<acronym title="Override the parsed C type with given type.">type</acronym> GObject.Object]

1550

1573

</td>

1551

1574

</tr>

1552

1575

<tr>

1553

1576

<td>Returns :</td>

1554

1577

<td>

1555

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

1578

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

1556

1579

</tr>

1557

1580

</tbody>

1558

1581

</table></div>

1585

1608

<hr>

1586

1609

1587

1610

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

1588

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

1611

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

1589

1612

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

1590

1613

1591

1614

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

1615

1638

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

1616

1639

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

1617

1640

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

1618

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

1641

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

1619

1642

1620

1643

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

1621

1644

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

1656

1679

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

1657

1680

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

1658

1681

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

1659

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

1682

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

1660

1683

1661

1684

Removes a weak reference callback to an object.

1662

1685

1686

1709

1687

1710

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

1688

1711

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

1689

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

1712

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

1690

1713

1691

1714

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

1692

1715

the pointer located at <code>weak_pointer_location</code> is only valid during

1693

1716

the lifetime of <code>object</code>. When the <code>object</code> is finalized,

1694

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

1717

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

1695

1718

1696

1719

1697

1720

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

1721

1744

1722

1745

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

1723

1746

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

1724

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

1747

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

1725

1748

1726

1749

Removes a weak reference from <code>object</code> that was previously added

1727

1750

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

1748

1771

<hr>

1749

1772

1750

1773

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

1751

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

1774

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

1752

1775

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

1753

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

1776

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

1754

1777

1755

1778

A callback function used for notification when the state

1756

1779

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

1773

1796

<tr>

1774

1797

1775

1798

<td>

1776

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

1777

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

1799

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

1800

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

1778

1801

reference was the last reference and there are now other

1779

1802

references.</td>

1780

1803

</tr>

1786

1809

<a name="g-object-add-toggle-ref"></a><h3>g_object_add_toggle_ref ()</h3>

1787

1810

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

1788

1811

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

1789

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

1812

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

1790

1813

1791

1814

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

1792

1815

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

1852

1875

<a name="g-object-remove-toggle-ref"></a><h3>g_object_remove_toggle_ref ()</h3>

1853

1876

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

1854

1877

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

1855

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

1878

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

1856

1879

1857

1880

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

1858

1881

reference count of the object is decreased by one.

1886

1909

<hr>

1887

1910

1888

1911

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

1889

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

1890

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

1912

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

1913

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

1891

1914

1892

1915

1893

1916

A convenience function to connect multiple signals at once.

1971

1994

<td class="listing_code"><pre class="programlisting">menu->toplevel = <a href="gobject-The-Base-Object-Type.html#g-object-connect">g_object_connect</a> (<a href="gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a> (GTK_TYPE_WINDOW,

1972

1995

"type", GTK_WINDOW_POPUP,

1973

1996

"child", menu,

1974

<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>),

1997

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>),

1975

1998

"signal::event", gtk_menu_window_event, menu,

1976

1999

"signal::size_request", gtk_menu_window_size_request, menu,

1977

2000

"signal::destroy", gtk_widget_destroyed, &menu->toplevel,

1978

2001

1979

2002

</tr>

1980

2003

</tbody>

1981

2004

</table>

2003

2026

<td>

2004

2027

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

2005

2028

first signal, followed optionally by more signal

2006

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

2029

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

2007

2030

</td>

2008

2031

</tr>

2009

2032

<tr>

2018

2041

<hr>

2019

2042

2020

2043

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

2021

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

2022

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

2044

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

2045

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

2023

2046

2024

2047

2025

2048

A convenience function to disconnect multiple signals at once.

2050

2073

<td>

2051

2074

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

2052

2075

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

2053

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

2076

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

2054

2077

</td>

2055

2078

</tr>

2056

2079

</tbody>

2059

2082

<hr>

2060

2083

2061

2084

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

2062

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

2063

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

2085

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

2086

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

2064

2087

2065

2088

2066

2089

Sets properties on an object.

2083

2106

<tr>

2084

2107

2085

2108

<td>value for the first property, followed optionally by more

2086

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

2109

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

2087

2110

</td>

2088

2111

</tr>

2089

2112

</tbody>

2092

2115

<hr>

2093

2116

2094

2117

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

2095

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

2096

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

2118

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

2119

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

2097

2120

2098

2121

2099

2122

Gets properties of an object.

2101

2124

2102

2125

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

2103

2126

is responsible for freeing the memory in the appropriate manner for

2104

the type, for instance by calling <a href="./../glib/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>.

2127

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

2105

2128

2106

2129

2107

2130

2108

2131

2109

<a name="id613836"></a>Example 2. Using g_object_get()

2132

<a name="id-1.4.5.7.49.6.1"></a>Example 2. Using g_object_get()

2110

2133

2111

2134

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

2112

2135

of three properties - one of type <a class="link" href="gobject-Type-Information.html#G-TYPE-INT:CAPS" title="G_TYPE_INT">G_TYPE_INT</a>,

2149

2172

<tr>

2150

2173

2151

2174

<td>return location for the first property, followed optionally by more

2152

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

2175

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

2153

2176

</td>

2154

2177

</tr>

2155

2178

</tbody>

2159

2182

2160

2183

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

2161

2184

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

2162

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

2185

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

2163

2186

2164

2187

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

2165

2188

2302

2325

Increases the freeze count on <code>object</code>. If the freeze count is

2303

2326

non-zero, the emission of "notify" signals on <code>object</code> is

2304

2327

stopped. The signals are queued until the freeze count is decreased

2305

to zero.

2328

to zero. Duplicate notifications are squashed so that at most one

2329

<a class="link" href="gobject-The-Base-Object-Type.html#GObject-notify" title='The "notify" signal'>"notify"</a> signal is emitted for each property modified while the

2330

object is frozen.

2306

2331

2307

2332

2308

2333

This is necessary for accessors that modify multiple properties to prevent

2327

2352

2328

2353

Reverts the effect of a previous call to

2329

2354

<a class="link" href="gobject-The-Base-Object-Type.html#g-object-freeze-notify" title="g_object_freeze_notify ()"><code class="function">g_object_freeze_notify()</code></a>. The freeze count is decreased on <code>object</code>

2330

and when it reaches zero, all queued "notify" signals are emitted.

2355

and when it reaches zero, queued "notify" signals are emitted.

2356

2357

2358

Duplicate notifications for each property are squashed so that at most one

2359

<a class="link" href="gobject-The-Base-Object-Type.html#GObject-notify" title='The "notify" signal'>"notify"</a> signal is emitted for each property.

2331

2360

2332

2361

2333

2362

It is an error to call this function when the freeze count is zero.

2347

2376

<hr>

2348

2377

2349

2378

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

2350

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

2351

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

2379

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

2380

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

2352

2381

2353

2382

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

2354

2383

2369

2398

</tr>

2370

2399

<tr>

2371

2400

<td>Returns :</td>

2372

<td>the data if found, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

2401

<td>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. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

2373

2402

</td>

2374

2403

</tr>

2375

2404

</tbody>

2379

2408

2380

2409

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

2381

2410

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

2382

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

2383

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

2411

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

2412

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

2384

2413

2385

2414

Each object carries around a table of associations from

2386

2415

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

2415

2444

2416

2445

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

2417

2446

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

2418

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

2419

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

2420

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

2447

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

2448

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

2449

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

2421

2450

2422

2451

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

2423

2452

for when the association is destroyed, either by setting it

2424

2453

to a different value or when the object is destroyed.

2425

2454

2426

2455

2427

Note that the <code>destroy</code> callback is not called if <code>data</code> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2456

Note that the <code>destroy</code> callback is not called if <code>data</code> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2428

2457

2429

2458

2430

2459

2455

2484

<hr>

2456

2485

2457

2486

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

2458

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

2459

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

2487

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

2488

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

2460

2489

2461

2490

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

2462

2491

without invoking the association's destroy handler.

2478

2507

</tr>

2479

2508

<tr>

2480

2509

<td>Returns :</td>

2481

<td>the data if found, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists. [<acronym title="Free data after the code is done.">transfer full</acronym>]

2482

</td>

2483

</tr>

2484

</tbody>

2485

</table></div>

2510

<td>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. [<acronym title="Free data after the code is done.">transfer full</acronym>]

2511

</td>

2512

</tr>

2513

</tbody>

2514

</table></div>

2515

</div>

2516

<hr>

2517

2518

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

2519

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

2520

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

2521

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

2522

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

2523

2524

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

2525

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

2526

meaning of 'duplicate' in this context, it could e.g.

2527

take a reference on a ref-counted object.

2528

2529

2530

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

2531

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

2532

2533

2534

Note that <code>dup_func</code> is called while user data of <code>object</code>

2535

is locked.

2536

2537

2538

This function can be useful to avoid races when multiple

2539

threads are using object data on the same key on the same

2540

object.

2541

2542

2543

2544

2545

<col>

2546

</colgroup>

2547

<tbody>

2548

<tr>

2549

<td><code>object</code> :</td>

2550

<td>the <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> to store user data on</td>

2551

</tr>

2552

<tr>

2553

2554

<td>a string, naming the user data pointer</td>

2555

</tr>

2556

<tr>

2557

2558

<td>function to dup the value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2559

</td>

2560

</tr>

2561

<tr>

2562

2563

<td>passed as user_data to <code>dup_func</code>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2564

</td>

2565

</tr>

2566

<tr>

2567

<td>Returns :</td>

2568

<td>the result of calling <code>dup_func</code> on the value

2569

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

2570

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

2571

unmodified.</td>

2572

</tr>

2573

</tbody>

2574

</table></div>

2575

Since 2.34

2576

</div>

2577

<hr>

2578

2579

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

2580

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

2581

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

2582

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

2583

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

2584

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

2585

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

2586

2587

Compares the user data for the key <code>key</code> on <code>object</code> with

2588

<code>oldval</code>, and if they are the same, replaces <code>oldval</code> with

2589

<code>newval</code>.

2590

2591

2592

This is like a typical atomic compare-and-exchange

2593

operation, for user data on an object.

2594

2595

2596

If the previous value was replaced then ownership of the

2597

old value (<code>oldval</code>) is passed to the caller, including

2598

the registred destroy notify for it (passed out in <code>old_destroy</code>).

2599

Its up to the caller to free this as he wishes, which may

2600

or may not include using <code>old_destroy</code> as sometimes replacement

2601

should not destroy the object in the normal way.

2602

2603

2604

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

2605

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

2606

2607

2608

2609

2610

<col>

2611

</colgroup>

2612

<tbody>

2613

<tr>

2614

<td><code>object</code> :</td>

2615

<td>the <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> to store user data on</td>

2616

</tr>

2617

<tr>

2618

2619

<td>a string, naming the user data pointer</td>

2620

</tr>

2621

<tr>

2622

<td><code>oldval</code> :</td>

2623

<td>the old value to compare against. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2624

</td>

2625

</tr>

2626

<tr>

2627

<td><code>newval</code> :</td>

2628

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

2629

</td>

2630

</tr>

2631

<tr>

2632

<td><code>destroy</code> :</td>

2633

<td>a destroy notify for the new value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2634

</td>

2635

</tr>

2636

<tr>

2637

<td><code>old_destroy</code> :</td>

2638

<td>destroy notify for the existing value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2639

</td>

2640

</tr>

2641

</tbody>

2642

</table></div>

2643

Since 2.34

2486

2644

</div>

2487

2645

<hr>

2488

2646

2489

2647

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

2490

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

2491

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

2648

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

2649

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

2492

2650

2493

2651

This function gets back user data pointers stored via

2494

2652

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

2505

2663

</tr>

2506

2664

<tr>

2507

2665

<td><code>quark</code> :</td>

2508

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

2666

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

2509

2667

</tr>

2510

2668

<tr>

2511

2669

<td>Returns :</td>

2512

<td>The user data pointer set, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

2670

<td>The user data pointer set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

2513

2671

</td>

2514

2672

</tr>

2515

2673

</tbody>

2519

2677

2520

2678

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

2521

2679

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

2522

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

2523

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

2680

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

2681

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

2524

2682

2525

2683

This sets an opaque, named pointer on an object.

2526

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

2527

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

2684

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

2685

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

2528

2686

can be gotten back from the <code>object</code> 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>

2529

2687

until the <code>object</code> is finalized.

2530

2688

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

2531

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

2689

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

2532

2690

removes the data stored.

2533

2691

2534

2692

2543

2701

</tr>

2544

2702

<tr>

2545

2703

<td><code>quark</code> :</td>

2546

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

2704

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

2547

2705

</tr>

2548

2706

<tr>

2549

2707

2556

2714

2557

2715

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

2558

2716

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

2559

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

2560

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

2561

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

2717

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

2718

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

2719

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

2562

2720

2563

2721

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,

2564

2722

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

2578

2736

</tr>

2579

2737

<tr>

2580

2738

<td><code>quark</code> :</td>

2581

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

2739

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

2582

2740

</tr>

2583

2741

<tr>

2584

2742

2595

2753

<hr>

2596

2754

2597

2755

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

2598

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

2599

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

2756

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

2757

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

2600

2758

2601

2759

This function gets back user data pointers stored via

2602

2760

<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> from object

2637

2795

const gchar *new_string)

2638

2796

{

2639

2797

// the quark, naming the object data

2640

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

2798

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

2641

2799

// retrive the old string list

2642

2800

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

2643

2801

2644

2802

// prepend new string

2645

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

2803

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));

2646

2804

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

2647

2805

<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);

2648

2806

}

2652

2810

GList *node, *list = data;

2653

2811

2654

2812

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

2655

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

2656

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

2813

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

2814

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

2657

2815

}</pre></td>

2658

2816

</tr>

2659

2817

</tbody>

2678

2836

</tr>

2679

2837

<tr>

2680

2838

<td><code>quark</code> :</td>

2681

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

2682

</tr>

2683

<tr>

2684

<td>Returns :</td>

2685

<td>The user data pointer set, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

2686

</td>

2687

</tr>

2688

</tbody>

2689

</table></div>

2839

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

2840

</tr>

2841

<tr>

2842

<td>Returns :</td>

2843

<td>The user data pointer set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

2844

</td>

2845

</tr>

2846

</tbody>

2847

</table></div>

2848

</div>

2849

<hr>

2850

2851

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

2852

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

2853

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

2854

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

2855

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

2856

2857

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

2858

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

2859

meaning of 'duplicate' in this context, it could e.g.

2860

take a reference on a ref-counted object.

2861

2862

2863

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

2864

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

2865

2866

2867

Note that <code>dup_func</code> is called while user data of <code>object</code>

2868

is locked.

2869

2870

2871

This function can be useful to avoid races when multiple

2872

threads are using object data on the same key on the same

2873

object.

2874

2875

2876

2877

2878

<col>

2879

</colgroup>

2880

<tbody>

2881

<tr>

2882

<td><code>object</code> :</td>

2883

<td>the <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> to store user data on</td>

2884

</tr>

2885

<tr>

2886

<td><code>quark</code> :</td>

2887

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

2888

</tr>

2889

<tr>

2890

2891

<td>function to dup the value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2892

</td>

2893

</tr>

2894

<tr>

2895

2896

2897

</td>

2898

</tr>

2899

<tr>

2900

<td>Returns :</td>

2901

<td>the result of calling <code>dup_func</code> on the value

2902

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

2903

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

2904

unmodified.</td>

2905

</tr>

2906

</tbody>

2907

</table></div>

2908

Since 2.34

2909

</div>

2910

<hr>

2911

2912

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

2913

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

2914

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

2915

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

2916

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

2917

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

2918

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

2919

2920

Compares the user data for the key <code>quark</code> on <code>object</code> with

2921

<code>oldval</code>, and if they are the same, replaces <code>oldval</code> with

2922

<code>newval</code>.

2923

2924

2925

This is like a typical atomic compare-and-exchange

2926

operation, for user data on an object.

2927

2928

2929

If the previous value was replaced then ownership of the

2930

old value (<code>oldval</code>) is passed to the caller, including

2931

the registred destroy notify for it (passed out in <code>old_destroy</code>).

2932

Its up to the caller to free this as he wishes, which may

2933

or may not include using <code>old_destroy</code> as sometimes replacement

2934

should not destroy the object in the normal way.

2935

2936

2937

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

2938

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

2939

2940

2941

2942

2943

<col>

2944

</colgroup>

2945

<tbody>

2946

<tr>

2947

<td><code>object</code> :</td>

2948

<td>the <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> to store user data on</td>

2949

</tr>

2950

<tr>

2951

<td><code>quark</code> :</td>

2952

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

2953

</tr>

2954

<tr>

2955

<td><code>oldval</code> :</td>

2956

<td>the old value to compare against. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2957

</td>

2958

</tr>

2959

<tr>

2960

<td><code>newval</code> :</td>

2961

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

2962

</td>

2963

</tr>

2964

<tr>

2965

<td><code>destroy</code> :</td>

2966

<td>a destroy notify for the new value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2967

</td>

2968

</tr>

2969

<tr>

2970

<td><code>old_destroy</code> :</td>

2971

<td>destroy notify for the existing value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

2972

</td>

2973

</tr>

2974

</tbody>

2975

</table></div>

2976

Since 2.34

2690

2977

</div>

2691

2978

<hr>

2692

2979

2693

2980

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

2694

2981

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

2695

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

2982

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

2696

2983

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

2697

2984

2698

2985

Sets a property on an object.

2723

3010

2724

3011

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

2725

3012

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

2726

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

3013

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

2727

3014

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

2728

3015

2729

3016

Gets a property of an object. <code>value</code> must have been initialized to the

2764

3051

2765

3052

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

2766

3053

<pre class="programlisting"><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> * g_object_new_valist (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> object_type</code>,

2767

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

3054

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

2768

3055

2769

3056

2770

3057

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

2790

3077

<tr>

2791

3078

2792

3079

<td>the value of the first property, followed optionally by more

2793

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

3080

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

2794

3081

</td>

2795

3082

</tr>

2796

3083

<tr>

2805

3092

2806

3093

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

2807

3094

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

2808

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

3095

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

2809

3096

2810

3097

2811

3098

Sets properties on an object.

2828

3115

<tr>

2829

3116

2830

3117

<td>value for the first property, followed optionally by more

2831

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

3118

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

2832

3119

</td>

2833

3120

</tr>

2834

3121

</tbody>

2838

3125

2839

3126

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

2840

3127

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

2841

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

3128

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

2842

3129

2843

3130

2844

3131

Gets properties of an object.

2846

3133

2847

3134

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

2848

3135

is responsible for freeing the memory in the appropriate manner for

2849

3136

2850

3137

2851

3138

2852

3139

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

2869

3156

<tr>

2870

3157

2871

3158

<td>return location for the first property, followed optionally by more

2872

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

3159

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

2873

3160

</td>

2874

3161

</tr>

2875

3162

</tbody>

2969

3256

</pre>

2970

3257

2971

3258

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

2972

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

3259

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

2973

3260

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

2974

3261

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>

2975

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

3262

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

2976

3263

2977

3264

2978

3265

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

2987

3274

2988

3275

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

2989

3276

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

2990

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

3277

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

2991

3278

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

2992

3279

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

2993

3280

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

2997

3284

2998

3285

2999

3286

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

3000

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

3287

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

3001

3288

3002

3289

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

3003

3290

3025

3312

</tr>

3026

3313

<tr>

3027

3314

<td><code>object</code> :</td>

3028

<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

3315

<td>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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

3029

3316

</td>

3030

3317

</tr>

3031

3318

</tbody>

3061

3348

<hr>

3062

3349

3063

3350

3064

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

3351

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

3065

3352

3066

3353

If <code>weak_ref</code> is not empty, atomically acquire a strong

3067

3354

reference to the object it points to, and return that reference.

3089

3376

<tr>

3090

3377

<td>Returns :</td>

3091

3378

<td>the object pointed to

3092

by <code>weak_ref</code>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it was empty. [<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]

3379

by <code>weak_ref</code>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it was empty. [<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]

3093

3380

</td>

3094

3381

</tr>

3095

3382

</tbody>

3100

3387

3101

3388

3102

3389

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

3103

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

3390

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

3104

3391

3105

3392

Change the object to which <code>weak_ref</code> points, or set it to

3106

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

3393

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

3107

3394

3108

3395

3109

3396

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

3121

3408

</tr>

3122

3409

<tr>

3123

3410

<td><code>object</code> :</td>

3124

3411

3125

3412

</td>

3126

3413

</tr>

3127

3414

</tbody>

3135

3422

<a name="GObject-notify"></a><h3>The <code class="literal">"notify"</code> signal</h3>

3136

3423

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

3137

3424

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

3138

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

3425

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

3139

3426

3140

3427

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

3141

3428

properties has been changed. Note that getting this signal

3197

3484

</div>

3198

3485

3199

3486

<hr>

3200

Generated by GTK-Doc V1.18</div>

3487

Generated by GTK-Doc V1.18.1</div>

3201

3488

</body>

3202

3489

</html>

b'\\ No newline at end of file'

Older »