~attente/glib/gbytesicon

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-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/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

156

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

157

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

158

<a href="./../glib/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/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

160

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

161

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

162

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

163

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

164

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

165

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

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

167

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

168

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

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

170

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

171

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

172

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

173

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

174

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

175

<a href="./../glib/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/glib-Quarks.html#GQuark">GQuark</a> quark</code>,

177

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

178

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

179

<a href="./../glib/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/glib-Quarks.html#GQuark">GQuark</a> quark</code>,

181

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

182

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

183

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

184

<code><a href="./../glib/glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> *old_destroy</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>);

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

186

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

187

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

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

189

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

190

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

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

192

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

193

<code>va_list var_args</code>);

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

195

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

196

<code>va_list var_args</code>);

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

198

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

199

<code>va_list var_args</code>);

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

201

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

206

207

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

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

209

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

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

211

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

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

213

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

214

</pre>

215

</div>

216

246

any code portion. The main motivation for providing floating references is

247

C convenience. In particular, it allows code to be written as:

248

249

250

container = create_container ();

251

container_add_child (container, create_child());

252

</pre></div>

249

250

251

<tbody>

252

<tr>

253

<td class="listing_lines" align="right"><pre>1

254

2</pre></td>

255

<td class="listing_code"><pre class="programlisting">container = create_container ();

256

container_add_child (container, create_child());</pre></td>

257

</tr>

258

</tbody>

259

</table>

260

</div>

261

253

262

254

263

If <code class="function"><code class="function">container_add_child()</code></code> will <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref-sink" title="g_object_ref_sink ()"><code class="function">g_object_ref_sink()</code></a> the

255

264

passed in child, no reference of the newly created child is leaked.

257

266

can only <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref" title="g_object_ref ()"><code class="function">g_object_ref()</code></a> the new child, so to implement this code without

258

267

reference leaks, it would have to be written as:

259

268

260

261

Child *child;

269

270

271

<tbody>

272

<tr>

273

<td class="listing_lines" align="right"><pre>1

274

275

276

277

5</pre></td>

278

<td class="listing_code"><pre class="programlisting">Child *child;

262

279

container = create_container ();

263

280

child = create_child ();

264

281

container_add_child (container, child);

265

g_object_unref (child);

266

</pre></div>

282

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

283

</tr>

284

</tbody>

285

</table>

286

</div>

287

267

288

268

289

The floating reference can be converted into

269

290

an ordinary reference by calling <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref-sink" title="g_object_ref_sink ()"><code class="function">g_object_ref_sink()</code></a>.

279

300

280

301

281

302

Some object implementations may need to save an objects floating state

282

across certain code portions (an example is <a href="http://developer.gnome.org/gtk2/GtkMenu.html">GtkMenu</a>), to achieve this,

303

across certain code portions (an example is GtkMenu), to achieve this,

283

304

the following sequence can be used:

284

305

285

306

286

307

287

288

/* save floating state */

289

gboolean was_floating = g_object_is_floating (object);

290

g_object_ref_sink (object);

291

/* protected code portion */

308

309

310

<tbody>

311

<tr>

312

<td class="listing_lines" align="right"><pre>1

313

314

315

316

317

318

319

320

321

10</pre></td>

322

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

323

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

324

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

325

/* protected code portion */

292

326

...;

293

/* restore floating state */

294

if (was_floating)

295

g_object_force_floating (object);

296

else

297

g_object_unref (object); /* release previously acquired reference */

298

</pre></div>

327

/* restore floating state */

328

if (was_floating)

329

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

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>

332

</tr>

333

</tbody>

334

</table>

335

</div>

336

299

337

300

338

301

339

</div>

348

386

349

387

350

388

351

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

352

353

static MySingleton *the_singleton = NULL;

389

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

390

391

392

<tbody>

393

<tr>

394

<td class="listing_lines" align="right"><pre>1

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

21</pre></td>

415

<td class="listing_code"><pre class="programlisting">static MySingleton *the_singleton = NULL;

354

416

355

static GObject*

356

my_singleton_constructor (GType type,

357

guint n_construct_params,

358

GObjectConstructParam *construct_params)

417

static GObject*

418

my_singleton_constructor (GType type,

419

guint n_construct_params,

420

GObjectConstructParam *construct_params)

359

421

{

360

GObject *object;

361

362

if (!the_singleton)

422

GObject *object;

423

424

if (!the_singleton)

363

425

{

364

object = G_OBJECT_CLASS (parent_class)->constructor (type,

426

object = G_OBJECT_CLASS (parent_class)->constructor (type,

365

427

n_construct_params,

366

428

construct_params);

367

429

the_singleton = MY_SINGLETON (object);

368

430

}

369

else

370

object = g_object_ref (G_OBJECT (the_singleton));

371

372

return object;

373

}

374

</pre></div>

431

else

432

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

433

434

return object;

435

}</pre></td>

436

</tr>

437

</tbody>

438

</table>

439

</div>

440

375

441

</div>

376

442

377

443

378

444

445

379

446

447

<col>

448

</colgroup>

380

449

<tbody>

381

450

<tr>

382

451

<td><a class="link" href="gobject-Type-Information.html#GTypeClass" title="struct GTypeClass">GTypeClass</a> <code><a name="GObjectClass.g-type-class"></a>g_type_class</code>;</td>

393

462

<tr>

394

463

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

395

464

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

396

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

397

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

398

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>

399

469

</tr>

400

470

<tr>

401

471

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

452

522

structure used to hand <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec">GParamSpec</a>/<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> pairs to the <code>constructor</code> of

453

523

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

454

524

455

525

526

456

527

528

<col>

529

</colgroup>

457

530

<tbody>

458

531

<tr>

459

532

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

470

543

471

544

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

472

545

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

473

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

474

547

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

475

548

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

476

549

477

550

The type of the <code>get_property</code> function of <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a>.

478

551

479

552

553

480

554

555

<col>

556

</colgroup>

481

557

<tbody>

482

558

<tr>

483

559

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

504

580

505

581

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

506

582

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

507

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

508

584

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

509

585

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

510

586

511

587

The type of the <code>set_property</code> function of <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a>.

512

588

513

589

590

514

591

592

<col>

593

</colgroup>

515

594

<tbody>

516

595

<tr>

517

596

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

541

620

542

621

The type of the <code>finalize</code> function of <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a>.

543

622

544

623

624

545

625

626

<col>

627

</colgroup>

546

628

547

629

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

548

630

<td>the <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> being finalized</td>

557

639

558

640

Check if the passed in type id 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> or derived from it.

559

641

560

642

643

561

644

645

<col>

646

</colgroup>

562

647

<tbody>

563

648

<tr>

564

649

567

652

<tr>

568

653

<td>Returns :</td>

569

654

<td>

570

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

571

656

</tr>

572

657

</tbody>

573

658

</table></div>

582

667

Depending on the current debugging level, this function may invoke

583

668

certain runtime checks to identify invalid casts.

584

669

585

670

671

586

672

673

<col>

674

</colgroup>

587

675

588

676

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

589

677

<td>Object which is subject to casting.</td>

598

686

599

687

Checks whether a valid <a class="link" href="gobject-Type-Information.html#GTypeInstance" title="struct GTypeInstance">GTypeInstance</a> pointer is of type <a class="link" href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS" title="G_TYPE_OBJECT"><code class="literal">G_TYPE_OBJECT</code></a>.

600

688

601

689

690

602

691

692

<col>

693

</colgroup>

603

694

604

695

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

605

696

<td>Instance to check for being 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>

614

705

615

706

Casts a derived <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> structure into a <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> structure.

616

707

617

708

709

618

710

711

<col>

712

</colgroup>

619

713

620

714

<td><code>class</code> :</td>

621

715

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

632

726

Checks whether <code>class</code> "is a" valid <a class="link" href="gobject-The-Base-Object-Type.html#GObjectClass" title="struct GObjectClass">GObjectClass</a> structure of type

633

727

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

634

728

635

729

730

636

731

732

<col>

733

</colgroup>

637

734

638

735

<td><code>class</code> :</td>

639

736

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

649

746

650

747

Get the class structure associated to a <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> instance.

651

748

652

749

750

653

751

752

<col>

753

</colgroup>

654

754

<tbody>

655

755

<tr>

656

756

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

671

771

672

772

Get the type id of an object.

673

773

674

774

775

675

776

777

<col>

778

</colgroup>

676

779

<tbody>

677

780

<tr>

678

781

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

693

796

694

797

Get the name of an object's type.

695

798

696

799

800

697

801

802

<col>

803

</colgroup>

698

804

<tbody>

699

805

<tr>

700

806

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

716

822

717

823

Get the type id of a class structure.

718

824

719

825

826

720

827

828

<col>

829

</colgroup>

721

830

<tbody>

722

831

<tr>

723

832

<td><code>class</code> :</td>

739

848

740

849

Return the name of a class structure's type.

741

850

742

851

852

743

853

854

<col>

855

</colgroup>

744

856

<tbody>

745

857

<tr>

746

858

<td><code>class</code> :</td>

759

871

760

872

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

761

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

762

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

763

875

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

764

876

765

877

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

769

881

by installing a property with the same name. This can be useful at times,

770

882

e.g. to change the range of allowed values or the default value.

771

883

772

884

885

773

886

887

<col>

888

</colgroup>

774

889

<tbody>

775

890

<tr>

776

891

<td><code>oclass</code> :</td>

792

907

793

908

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

794

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

795

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

796

911

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

797

912

798

913

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

813

928

814

929

815

930

816

817

enum {

931

932

933

<tbody>

934

<tr>

935

<td class="listing_lines" align="right"><pre>1

936

937

938

939

940

941

942

943

944

945

946

947

948

949

950

951

952

953

954

955

956

957

958

959

960

961

962

28</pre></td>

963

<td class="listing_code"><pre class="programlisting">enum {

818

964

PROP_0, PROP_FOO, PROP_BAR, N_PROPERTIES

819

965

};

820

966

821

static GParamSpec *obj_properties[N_PROPERTIES] = { NULL, };

967

static GParamSpec *obj_properties[N_PROPERTIES] = { NULL, };

822

968

823

static void

969

static void

824

970

my_object_class_init (MyObjectClass *klass)

825

971

{

826

GObjectClass *gobject_class = G_OBJECT_CLASS (klass);

972

GObjectClass *gobject_class = G_OBJECT_CLASS (klass);

827

973

828

974

obj_properties[PROP_FOO] =

829

g_param_spec_int ("foo", "Foo", "Foo",

830

-1, G_MAXINT,

831

832

G_PARAM_READWRITE);

975

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

976

-1, G_MAXINT,

977

0,

978

G_PARAM_READWRITE);

833

979

834

980

obj_properties[PROP_BAR] =

835

g_param_spec_string ("bar", "Bar", "Bar",

836

NULL,

837

G_PARAM_READWRITE);

981

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

982

NULL,

983

G_PARAM_READWRITE);

838

984

839

985

gobject_class->set_property = my_object_set_property;

840

986

gobject_class->get_property = my_object_get_property;

841

g_object_class_install_properties (gobject_class,

987

<a href="gobject-The-Base-Object-Type.html#g-object-class-install-properties">g_object_class_install_properties</a> (gobject_class,

842

988

N_PROPERTIES,

843

989

obj_properties);

844

}

845

</pre></div>

990

}</pre></td>

991

</tr>

992

</tbody>

993

</table>

994

</div>

995

846

996

847

997

848

998

850

1000

851

1001

852

1002

853

854

void

855

my_object_set_foo (MyObject *self, gint foo)

1003

1004

1005

<tbody>

1006

<tr>

1007

<td class="listing_lines" align="right"><pre>1

1008

1009

1010

1011

1012

1013

1014

1015

9</pre></td>

1016

<td class="listing_code"><pre class="programlisting">void

1017

my_object_set_foo (MyObject *self, gint foo)

856

1018

{

857

if (self->foo != foo)

1019

if (self->foo != foo)

858

1020

{

859

1021

self->foo = foo;

860

g_object_notify_by_pspec (G_OBJECT (self), obj_properties[PROP_FOO]);

1022

<a href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec">g_object_notify_by_pspec</a> (G_OBJECT (self), obj_properties[PROP_FOO]);

861

1023

}

862

}

863

</pre></div>

1024

}</pre></td>

1025

</tr>

1026

</tbody>

1027

</table>

1028

</div>

1029

864

1030

865

1031

866

1032

1033

867

1034

1035

<col>

1036

</colgroup>

868

1037

<tbody>

869

1038

<tr>

870

1039

<td><code>oclass</code> :</td>

889

1058

890

1059

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

891

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

892

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

893

1062

894

1063

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

895

1064

896

1065

1066

897

1067

1068

<col>

1069

</colgroup>

898

1070

<tbody>

899

1071

<tr>

900

1072

<td><code>oclass</code> :</td>

908

1080

<tr>

909

1081

<td>Returns :</td>

910

1082

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

911

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

912

1084

</td>

913

1085

</tr>

914

1086

</tbody>

918

1090

919

1091

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

920

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

921

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

922

1094

923

1095

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

924

1096

925

1097

1098

926

1099

1100

<col>

1101

</colgroup>

927

1102

<tbody>

928

1103

<tr>

929

1104

<td><code>oclass</code> :</td>

948

1123

949

1124

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

950

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

951

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

952

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

953

1128

954

1129

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

955

1130

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

974

1149

</div>

975

1150

976

1151

977

1152

1153

978

1154

1155

<col>

1156

</colgroup>

979

1157

<tbody>

980

1158

<tr>

981

1159

<td><code>oclass</code> :</td>

998

1176

<hr>

999

1177

1000

1178

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

1001

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

1002

1180

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

1003

1181

1004

1182

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

1017

1195

<a class="link" href="gobject-Type-Information.html#GTypeInfo" title="struct GTypeInfo">GTypeInfo</a>.) It must not be called after after <code>class_init</code> has

1018

1196

been called for any object types implementing this interface.

1019

1197

1020

1198

1199

1021

1200

1201

<col>

1202

</colgroup>

1022

1203

<tbody>

1023

1204

<tr>

1024

1205

<td><code>g_iface</code> :</td>

1036

1217

<hr>

1037

1218

1038

1219

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

1039

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

1040

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

1041

1222

1042

1223

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

1043

1224

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

1045

1226

if you know the interface has already been loaded,

1046

1227

<a class="link" href="gobject-Type-Information.html#g-type-default-interface-peek" title="g_type_default_interface_peek ()"><code class="function">g_type_default_interface_peek()</code></a>.

1047

1228

1048

1229

1230

1049

1231

1232

<col>

1233

</colgroup>

1050

1234

<tbody>

1051

1235

<tr>

1052

1236

<td><code>g_iface</code> :</td>

1060

1244

<tr>

1061

1245

<td>Returns :</td>

1062

1246

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

1063

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

1064

1248

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

1065

1249

</td>

1066

1250

</tr>

1071

1255

<hr>

1072

1256

1073

1257

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

1074

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

1075

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

1076

1260

1077

1261

Lists the properties of an interface.Generally, the interface

1078

1262

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

1079

1263

<a class="link" href="gobject-Type-Information.html#g-type-default-interface-ref" title="g_type_default_interface_ref ()"><code class="function">g_type_default_interface_ref()</code></a>, or, if you know the interface has

1080

1264

already been loaded, <a class="link" href="gobject-Type-Information.html#g-type-default-interface-peek" title="g_type_default_interface_peek ()"><code class="function">g_type_default_interface_peek()</code></a>.

1081

1265

1082

1266

1267

1083

1268

1269

<col>

1270

</colgroup>

1084

1271

<tbody>

1085

1272

<tr>

1086

1273

<td><code>g_iface</code> :</td>

1097

1284

<td>a

1098

1285

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

1099

1286

structures. The paramspecs are owned by GLib, but the

1100

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

1101

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

1102

1289

</td>

1103

1290

</tr>

1108

1295

<hr>

1109

1296

1110

1297

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

1111

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

1112

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

1113

1300

1114

1301

1115

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.

1118

1305

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

1119

1306

which are not explicitly specified are set to their default values.

1120

1307

1121

1308

1309

1122

1310

1311

<col>

1312

</colgroup>

1123

1313

<tbody>

1124

1314

<tr>

1125

1315

<td><code>object_type</code> :</td>

1132

1322

<tr>

1133

1323

1134

1324

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

1135

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>

1136

1326

</td>

1137

1327

</tr>

1138

1328

<tr>

1146

1336

<hr>

1147

1337

1148

1338

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

1149

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

1150

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

1151

1341

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

1152

1342

1153

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.

1159

1349

1160

1350

Rename to: g_object_new

1161

1351

1162

1352

1353

1163

1354

1355

<col>

1356

</colgroup>

1164

1357

<tbody>

1165

1358

<tr>

1166

1359

<td><code>object_type</code> :</td>

1178

1371

<tr>

1179

1372

<td>Returns :</td>

1180

1373

<td>a new instance of

1181

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

1182

1375

</td>

1183

1376

</tr>

1184

1377

</tbody>

1196

1389

The GParameter struct is an auxiliary structure used

1197

1390

to hand parameter name/value pairs to <a class="link" href="gobject-The-Base-Object-Type.html#g-object-newv" title="g_object_newv ()"><code class="function">g_object_newv()</code></a>.

1198

1391

1199

1392

1393

1200

1394

1395

<col>

1396

</colgroup>

1201

1397

<tbody>

1202

1398

<tr>

1203

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

1204

1400

<td>the parameter name</td>

1205

1401

</tr>

1206

1402

<tr>

1213

1409

<hr>

1214

1410

1215

1411

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

1216

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

1217

1413

1218

1414

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

1219

1415

1220

1416

1417

1221

1418

1419

<col>

1420

</colgroup>

1222

1421

<tbody>

1223

1422

<tr>

1224

1423

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

1225

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

1226

1425

</td>

1227

1426

</tr>

1228

1427

<tr>

1229

1428

<td>Returns :</td>

1230

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

1231

1430

</td>

1232

1431

</tr>

1233

1432

</tbody>

1236

1435

<hr>

1237

1436

1238

1437

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

1239

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

1240

1439

1241

1440

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

1242

1441

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

1243

1442

1244

1443

1444

1245

1445

1446

<col>

1447

</colgroup>

1246

1448

1247

1449

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

1248

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]

1249

1451

</td>

1250

1452

</tr></tbody>

1251

1453

</table></div>

1253

1455

<hr>

1254

1456

1255

1457

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

1256

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

1257

1459

1258

1460

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

1259

1461

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

1266

1468

count unchanged. If the object is not floating, then this call

1267

1469

adds a new normal reference increasing the reference count by one.

1268

1470

1269

1471

1472

1270

1473

1474

<col>

1475

</colgroup>

1271

1476

<tbody>

1272

1477

<tr>

1273

1478

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

1274

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]

1275

1480

</td>

1276

1481

</tr>

1277

1482

<tr>

1278

1483

<td>Returns :</td>

1279

1484

<td>

1280

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

1281

1486

</td>

1282

1487

</tr>

1283

1488

</tbody>

1292

1497

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

1293

1498

1294

1499

1295

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

1296

1501

1297

1502

1298

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.

1299

1504

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

1300

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

1301

1506

1302

1507

1303

1508

This function is threadsafe and modifies the pointer atomically,

1307

1512

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

1308

1513

pointer casts.

1309

1514

1310

1515

1516

1311

1517

1518

<col>

1519

</colgroup>

1312

1520

1313

1521

<td><code>object_ptr</code> :</td>

1314

1522

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

1348

1556

<hr>

1349

1557

1350

1558

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

1351

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

1352

1560

1353

1561

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

1354

1562

reference.

1355

1563

1356

1564

1565

1357

1566

1567

<col>

1568

</colgroup>

1358

1569

<tbody>

1359

1570

<tr>

1360

1571

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

1361

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]

1362

1573

</td>

1363

1574

</tr>

1364

1575

<tr>

1365

1576

<td>Returns :</td>

1366

1577

<td>

1367

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

1368

1579

</tr>

1369

1580

</tbody>

1370

1581

</table></div>

1381

1592

<a class="link" href="gobject-The-Base-Object-Type.html#GInitiallyUnowned" title="GInitiallyUnowned">GInitiallyUnowned</a>s are created with a floating reference which

1382

1593

usually just needs to be sunken by calling <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref-sink" title="g_object_ref_sink ()"><code class="function">g_object_ref_sink()</code></a>.

1383

1594

1384

1595

1596

1385

1597

1598

<col>

1599

</colgroup>

1386

1600

1387

1601

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

1388

1602

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

1394

1608

<hr>

1395

1609

1396

1610

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

1397

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

1398

1612

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

1399

1613

1400

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

1402

1616

finalized when the <a class="link" href="gobject-The-Base-Object-Type.html#GWeakNotify" title="GWeakNotify ()">GWeakNotify</a> is called, there's not much you could do

1403

1617

with the object, apart from e.g. using its address as hash-index or the like.

1404

1618

1405

1619

1620

1406

1621

1622

<col>

1623

</colgroup>

1407

1624

<tbody>

1408

1625

<tr>

1409

1626

1421

1638

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

1422

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

1423

1640

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

1424

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

1425

1642

1426

1643

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

1427

1644

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

1435

1652

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

1436

1653

Use <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> if thread-safety is required.

1437

1654

1438

1655

1656

1439

1657

1658

<col>

1659

</colgroup>

1440

1660

<tbody>

1441

1661

<tr>

1442

1662

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

1459

1679

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

1460

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

1461

1681

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

1462

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

1463

1683

1464

1684

Removes a weak reference callback to an object.

1465

1685

1466

1686

1687

1467

1688

1689

<col>

1690

</colgroup>

1468

1691

<tbody>

1469

1692

<tr>

1470

1693

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

1486

1709

1487

1710

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

1488

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

1489

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

1490

1713

1491

1714

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

1492

1715

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

1493

1716

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

1494

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

1495

1718

1496

1719

1497

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

1499

1722

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

1500

1723

thread. Use <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> if thread-safety is required.

1501

1724

1502

1725

1726

1503

1727

1728

<col>

1729

</colgroup>

1504

1730

<tbody>

1505

1731

<tr>

1506

1732

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

1518

1744

1519

1745

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

1520

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

1521

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

1522

1748

1523

1749

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

1524

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

1525

1751

to match the one used with <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>.

1526

1752

1527

1753

1754

1528

1755

1756

<col>

1757

</colgroup>

1529

1758

<tbody>

1530

1759

<tr>

1531

1760

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

1542

1771

<hr>

1543

1772

1544

1773

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

1545

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

1546

1775

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

1547

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

1548

1777

1549

1778

A callback function used for notification when the state

1550

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

1551

1780

1552

1781

1782

1553

1783

1784

<col>

1785

</colgroup>

1554

1786

<tbody>

1555

1787

<tr>

1556

1788

1564

1796

<tr>

1565

1797

1566

1798

<td>

1567

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

1568

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

1569

1801

reference was the last reference and there are now other

1570

1802

references.</td>

1571

1803

</tr>

1577

1809

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

1578

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

1579

1811

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

1580

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

1581

1813

1582

1814

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

1583

1815

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

1612

1844

this reason, you should only ever use a toggle reference if there

1613

1845

is important state in the proxy object.

1614

1846

1615

1847

1848

1616

1849

1850

<col>

1851

</colgroup>

1617

1852

<tbody>

1618

1853

<tr>

1619

1854

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

1640

1875

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

1641

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

1642

1877

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

1643

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

1644

1879

1645

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

1646

1881

reference count of the object is decreased by one.

1647

1882

1648

1883

1884

1649

1885

1886

<col>

1887

</colgroup>

1650

1888

<tbody>

1651

1889

<tr>

1652

1890

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

1671

1909

<hr>

1672

1910

1673

1911

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

1674

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

1675

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

1676

1914

1677

1915

1678

1916

A convenience function to connect multiple signals at once.

1681

1919

The signal specs expected by this function have the form

1682

1920

"modifier::signal_name", where modifier can be one of the following:

1683

1921

1684

1922

1923

1685

1924

1925

<col>

1926

</colgroup>

1686

1927

<tbody>

1687

1928

<tr>

1688

1929

<td>signal</td>

1738

1979

1739

1980

1740

1981

1741

1742

menu->toplevel = g_object_connect (g_object_new (GTK_TYPE_WINDOW,

1743

"type", GTK_WINDOW_POPUP,

1744

"child", menu,

1745

NULL),

1746

"signal::event", gtk_menu_window_event, menu,

1747

"signal::size_request", gtk_menu_window_size_request, menu,

1748

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

1749

NULL);

1750

</pre></div>

1982

1983

1984

<tbody>

1985

<tr>

1986

<td class="listing_lines" align="right"><pre>1

1987

1988

1989

1990

1991

1992

1993

8</pre></td>

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,

1995

"type", GTK_WINDOW_POPUP,

1996

"child", menu,

1997

NULL),

1998

"signal::event", gtk_menu_window_event, menu,

1999

"signal::size_request", gtk_menu_window_size_request, menu,

2000

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

2001

NULL);</pre></td>

2002

</tr>

2003

</tbody>

2004

</table>

2005

</div>

2006

1751

2007

1752

2008

1753

2009

2010

1754

2011

2012

<col>

2013

</colgroup>

1755

2014

<tbody>

1756

2015

<tr>

1757

2016

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

1767

2026

<td>

1768

2027

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

1769

2028

first signal, followed optionally by more signal

1770

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>

1771

2030

</td>

1772

2031

</tr>

1773

2032

<tr>

1782

2041

<hr>

1783

2042

1784

2043

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

1785

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

1786

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

1787

2046

1788

2047

1789

2048

A convenience function to disconnect multiple signals at once.

1794

2053

callback and data, or "any_signal::signal_name", which only

1795

2054

disconnects the signal named "signal_name".

1796

2055

1797

2056

2057

1798

2058

2059

<col>

2060

</colgroup>

1799

2061

<tbody>

1800

2062

<tr>

1801

2063

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

1811

2073

<td>

1812

2074

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

1813

2075

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

1814

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>

1815

2077

</td>

1816

2078

</tr>

1817

2079

</tbody>

1820

2082

<hr>

1821

2083

1822

2084

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

1823

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

1824

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

1825

2087

1826

2088

1827

2089

Sets properties on an object.

1828

2090

1829

2091

2092

1830

2093

2094

<col>

2095

</colgroup>

1831

2096

<tbody>

1832

2097

<tr>

1833

2098

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

1841

2106

<tr>

1842

2107

1843

2108

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

1844

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>

1845

2110

</td>

1846

2111

</tr>

1847

2112

</tbody>

1850

2115

<hr>

1851

2116

1852

2117

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

1853

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

1854

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

1855

2120

1856

2121

1857

2122

Gets properties of an object.

1859

2124

1860

2125

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

1861

2126

is responsible for freeing the memory in the appropriate manner for

1862

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

1863

2128

1864

2129

1865

2130

1866

2131

1867

<a name="idp20071680"></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()

1868

2133

1869

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

1870

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

1889

2154

</div>

1890

2155

1891

2156

1892

2157

2158

1893

2159

2160

<col>

2161

</colgroup>

1894

2162

<tbody>

1895

2163

<tr>

1896

2164

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

1904

2172

<tr>

1905

2173

1906

2174

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

1907

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>

1908

2176

</td>

1909

2177

</tr>

1910

2178

</tbody>

1914

2182

1915

2183

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

1916

2184

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

1917

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

1918

2186

1919

2187

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

1920

2188

1923

2191

that registered the property, you should use <a class="link" href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec" title="g_object_notify_by_pspec ()"><code class="function">g_object_notify_by_pspec()</code></a>

1924

2192

instead.

1925

2193

1926

2194

2195

1927

2196

2197

<col>

2198

</colgroup>

1928

2199

<tbody>

1929

2200

<tr>

1930

2201

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

1958

2229

1959

2230

1960

2231

1961

1962

enum

2232

2233

2234

<tbody>

2235

<tr>

2236

<td class="listing_lines" align="right"><pre>1

2237

2238

2239

2240

2241

2242

2243

2244

2245

2246

2247

2248

2249

2250

2251

2252

2253

2254

2255

20</pre></td>

2256

<td class="listing_code"><pre class="programlisting">enum

1963

2257

{

1964

2258

PROP_0,

1965

2259

PROP_FOO,

1966

2260

PROP_LAST

1967

2261

};

1968

2262

1969

static GParamSpec *properties[PROP_LAST];

2263

static GParamSpec *properties[PROP_LAST];

1970

2264

1971

static void

2265

static void

1972

2266

my_object_class_init (MyObjectClass *klass)

1973

2267

{

1974

properties[PROP_FOO] = g_param_spec_int ("foo", "Foo", "The foo",

1975

0, 100,

1976

50,

1977

G_PARAM_READWRITE);

1978

g_object_class_install_property (gobject_class,

2268

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

2269

0, 100,

2270

50,

2271

G_PARAM_READWRITE);

2272

<a href="gobject-The-Base-Object-Type.html#g-object-class-install-property">g_object_class_install_property</a> (gobject_class,

1979

2273

PROP_FOO,

1980

2274

properties[PROP_FOO]);

1981

}

1982

</pre></div>

2275

}</pre></td>

2276

</tr>

2277

</tbody>

2278

</table>

2279

</div>

2280

1983

2281

1984

2282

1985

2283

1987

2285

1988

2286

1989

2287

1990

1991

g_object_notify_by_pspec (self, properties[PROP_FOO]);

1992

</pre></div>

2288

2289

2290

<tbody>

2291

<tr>

2292

2293

<td class="listing_code"><pre class="programlisting"><a href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec">g_object_notify_by_pspec</a> (self, properties[PROP_FOO]);</pre></td>

2294

</tr>

2295

</tbody>

2296

</table>

2297

</div>

2298

1993

2299

1994

2300

1995

2301

2302

1996

2303

2304

<col>

2305

</colgroup>

1997

2306

<tbody>

1998

2307

<tr>

1999

2308

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

2024

2333

This is necessary for accessors that modify multiple properties to prevent

2025

2334

premature notification while the object is still being modified.

2026

2335

2027

2336

2337

2028

2338

2339

<col>

2340

</colgroup>

2029

2341

2030

2342

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

2031

2343

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

2049

2361

2050

2362

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

2051

2363

2052

2364

2365

2053

2366

2367

<col>

2368

</colgroup>

2054

2369

2055

2370

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

2056

2371

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

2061

2376

<hr>

2062

2377

2063

2378

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

2064

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

2065

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

2066

2381

2067

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

2068

2383

2069

2384

2385

2070

2386

2387

<col>

2388

</colgroup>

2071

2389

<tbody>

2072

2390

<tr>

2073

2391

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

2080

2398

</tr>

2081

2399

<tr>

2082

2400

<td>Returns :</td>

2083

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

2084

2402

</td>

2085

2403

</tr>

2086

2404

</tbody>

2090

2408

2091

2409

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

2092

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

2093

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

2094

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

2095

2413

2096

2414

Each object carries around a table of associations from

2097

2415

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

2100

2418

If the object already had an association with that name,

2101

2419

the old association will be destroyed.

2102

2420

2103

2421

2422

2104

2423

2424

<col>

2425

</colgroup>

2105

2426

<tbody>

2106

2427

<tr>

2107

2428

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

2123

2444

2124

2445

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

2125

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

2126

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

2127

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

2128

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

2129

2450

2130

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

2131

2452

for when the association is destroyed, either by setting it

2132

2453

to a different value or when the object is destroyed.

2133

2454

2134

2455

2135

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

2136

2457

2137

2458

2459

2138

2460

2461

<col>

2462

</colgroup>

2139

2463

<tbody>

2140

2464

<tr>

2141

2465

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

2160

2484

<hr>

2161

2485

2162

2486

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

2163

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

2164

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

2165

2489

2166

2490

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

2167

2491

without invoking the association's destroy handler.

2168

2492

2169

2493

2494

2170

2495

2496

<col>

2497

</colgroup>

2171

2498

<tbody>

2172

2499

<tr>

2173

2500

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

2180

2507

</tr>

2181

2508

<tr>

2182

2509

<td>Returns :</td>

2183

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

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

2184

2511

</td>

2185

2512

</tr>

2186

2513

</tbody>

2189

2516

<hr>

2190

2517

2191

2518

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

2192

<pre class="programlisting"><a href="./../glib/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>,

2193

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

2194

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

2195

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

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>

2196

2523

2197

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

2198

2525

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

2201

2528

2202

2529

2203

2530

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

2204

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

2531

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

2205

2532

2206

2533

2207

2534

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

2212

2539

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

2213

2540

object.

2214

2541

2215

2542

2543

2216

2544

2545

<col>

2546

</colgroup>

2217

2547

<tbody>

2218

2548

<tr>

2219

2549

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

2236

2566

<tr>

2237

2567

<td>Returns :</td>

2238

2568

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

2239

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

2240

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

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

2241

2571

unmodified.</td>

2242

2572

</tr>

2243

2573

</tbody>

2247

2577

<hr>

2248

2578

2249

2579

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

2250

<pre class="programlisting"><a href="./../glib/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>,

2251

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

2252

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

2253

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

2254

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

2255

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

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>

2256

2586

2257

2587

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

2258

2588

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

2271

2601

should not destroy the object in the normal way.

2272

2602

2273

2603

2274

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

2275

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

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.

2276

2606

2277

2607

2608

2278

2609

2610

<col>

2611

</colgroup>

2279

2612

<tbody>

2280

2613

<tr>

2281

2614

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

2312

2645

<hr>

2313

2646

2314

2647

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

2315

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

2316

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

2317

2650

2318

2651

This function gets back user data pointers stored via

2319

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

2320

2653

2321

2654

2655

2322

2656

2657

<col>

2658

</colgroup>

2323

2659

<tbody>

2324

2660

<tr>

2325

2661

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

2327

2663

</tr>

2328

2664

<tr>

2329

2665

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

2330

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

2331

2667

</tr>

2332

2668

<tr>

2333

2669

<td>Returns :</td>

2334

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

2335

2671

</td>

2336

2672

</tr>

2337

2673

</tbody>

2341

2677

2342

2678

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

2343

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

2344

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

2345

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

2346

2682

2347

2683

This sets an opaque, named pointer on an object.

2348

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

2349

<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

2350

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>

2351

2687

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

2352

2688

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

2353

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

2354

2690

removes the data stored.

2355

2691

2356

2692

2693

2357

2694

2695

<col>

2696

</colgroup>

2358

2697

<tbody>

2359

2698

<tr>

2360

2699

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

2362

2701

</tr>

2363

2702

<tr>

2364

2703

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

2365

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

2366

2705

</tr>

2367

2706

<tr>

2368

2707

2375

2714

2376

2715

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

2377

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

2378

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

2379

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

2380

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

2381

2720

2382

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,

2383

2722

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

2385

2724

the data is being overwritten by a call to <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>

2386

2725

with the same <code>quark</code>.

2387

2726

2388

2727

2728

2389

2729

2730

<col>

2731

</colgroup>

2390

2732

<tbody>

2391

2733

<tr>

2392

2734

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

2394

2736

</tr>

2395

2737

<tr>

2396

2738

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

2397

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

2398

2740

</tr>

2399

2741

<tr>

2400

2742

2411

2753

<hr>

2412

2754

2413

2755

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

2414

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

2415

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

2416

2758

2417

2759

This function gets back user data pointers stored via

2418

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

2421

2763

Usually, calling this function is only required to update

2422

2764

user data pointers with a destroy notifier, for example:

2423

2765

2424

2425

void

2426

object_add_to_user_list (GObject *object,

2427

const gchar *new_string)

2428

{

2429

// the quark, naming the object data

2430

GQuark quark_string_list = g_quark_from_static_string ("my-string-list");

2431

// retrive the old string list

2432

GList *list = g_object_steal_qdata (object, quark_string_list);

2433

2434

// prepend new string

2435

list = g_list_prepend (list, g_strdup (new_string));

2436

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

2437

g_object_set_qdata_full (object, quark_string_list, list, free_string_list);

2438

}

2439

static void

2440

free_string_list (gpointer data)

2441

{

2442

GList *node, *list = data;

2443

2444

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

2445

g_free (node->data);

2446

g_list_free (list);

2447

}

2448

</pre></div>

2766

2767

2768

<tbody>

2769

<tr>

2770

<td class="listing_lines" align="right"><pre>1

2771

2772

2773

2774

2775

2776

2777

2778

2779

2780

2781

2782

2783

2784

2785

2786

2787

2788

2789

2790

2791

2792

23</pre></td>

2793

<td class="listing_code"><pre class="programlisting">void

2794

object_add_to_user_list (GObject *object,

2795

const gchar *new_string)

2796

{

2797

// the quark, naming the object data

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

2799

// retrive the old string list

2800

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

2801

2802

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

2804

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

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

2806

}

2807

static void

2808

free_string_list (gpointer data)

2809

{

2810

GList *node, *list = data;

2811

2812

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

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

2815

}</pre></td>

2816

</tr>

2817

</tbody>

2818

</table>

2819

</div>

2820

2449

2821

2450

2822

Using <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> in the above example, instead of

2451

2823

<a class="link" href="gobject-The-Base-Object-Type.html#g-object-steal-qdata" title="g_object_steal_qdata ()"><code class="function">g_object_steal_qdata()</code></a> would have left the destroy function set,

2452

2824

and thus the partial string list would have been freed upon

2453

2825

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

2454

2826

2455

2827

2828

2456

2829

2830

<col>

2831

</colgroup>

2457

2832

<tbody>

2458

2833

<tr>

2459

2834

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

2461

2836

</tr>

2462

2837

<tr>

2463

2838

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

2464

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

2839

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

2465

2840

</tr>

2466

2841

<tr>

2467

2842

<td>Returns :</td>

2468

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

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

2469

2844

</td>

2470

2845

</tr>

2471

2846

</tbody>

2474

2849

<hr>

2475

2850

2476

2851

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

2477

<pre class="programlisting"><a href="./../glib/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>,

2478

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

2479

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

2480

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

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>

2481

2856

2482

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

2483

2858

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

2486

2861

2487

2862

2488

2863

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

2489

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

2864

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

2490

2865

2491

2866

2492

2867

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

2497

2872

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

2498

2873

object.

2499

2874

2500

2875

2876

2501

2877

2878

<col>

2879

</colgroup>

2502

2880

<tbody>

2503

2881

<tr>

2504

2882

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

2506

2884

</tr>

2507

2885

<tr>

2508

2886

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

2509

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

2887

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

2510

2888

</tr>

2511

2889

<tr>

2512

2890

2521

2899

<tr>

2522

2900

<td>Returns :</td>

2523

2901

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

2524

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

2525

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

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

2526

2904

unmodified.</td>

2527

2905

</tr>

2528

2906

</tbody>

2532

2910

<hr>

2533

2911

2534

2912

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

2535

<pre class="programlisting"><a href="./../glib/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>,

2536

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

2537

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

2538

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

2539

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

2540

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

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>

2541

2919

2542

2920

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

2543

2921

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

2556

2934

should not destroy the object in the normal way.

2557

2935

2558

2936

2559

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

2560

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

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.

2561

2939

2562

2940

2941

2563

2942

2943

<col>

2944

</colgroup>

2564

2945

<tbody>

2565

2946

<tr>

2566

2947

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

2568

2949

</tr>

2569

2950

<tr>

2570

2951

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

2571

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

2952

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

2572

2953

</tr>

2573

2954

<tr>

2574

2955

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

2598

2979

2599

2980

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

2600

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

2601

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

2602

2983

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

2603

2984

2604

2985

Sets a property on an object.

2605

2986

2606

2987

2988

2607

2989

2990

<col>

2991

</colgroup>

2608

2992

<tbody>

2609

2993

<tr>

2610

2994

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

2626

3010

2627

3011

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

2628

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

2629

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

2630

3014

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

2631

3015

2632

3016

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

2641

3025

Note that <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-property" title="g_object_get_property ()"><code class="function">g_object_get_property()</code></a> is really intended for language

2642

3026

bindings, <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> is much more convenient for C programming.

2643

3027

2644

3028

3029

2645

3030

3031

<col>

3032

</colgroup>

2646

3033

<tbody>

2647

3034

<tr>

2648

3035

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

2664

3051

2665

3052

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

2666

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

2667

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

2668

3055

2669

3056

2670

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.

2673

3060

2674

3061

which are not explicitly specified are set to their default values.

2675

3062

2676

3063

3064

2677

3065

3066

<col>

3067

</colgroup>

2678

3068

<tbody>

2679

3069

<tr>

2680

3070

<td><code>object_type</code> :</td>

2687

3077

<tr>

2688

3078

2689

3079

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

2690

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>

2691

3081

</td>

2692

3082

</tr>

2693

3083

<tr>

2702

3092

2703

3093

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

2704

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

2705

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

2706

3096

2707

3097

2708

3098

Sets properties on an object.

2709

3099

2710

3100

3101

2711

3102

3103

<col>

3104

</colgroup>

2712

3105

<tbody>

2713

3106

<tr>

2714

3107

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

2722

3115

<tr>

2723

3116

2724

3117

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

2725

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>

2726

3119

</td>

2727

3120

</tr>

2728

3121

</tbody>

2732

3125

2733

3126

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

2734

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

2735

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

2736

3129

2737

3130

2738

3131

Gets properties of an object.

2740

3133

2741

3134

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

2742

3135

is responsible for freeing the memory in the appropriate manner for

2743

3136

2744

3137

2745

3138

2746

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

2747

3140

2748

3141

3142

2749

3143

3144

<col>

3145

</colgroup>

2750

3146

<tbody>

2751

3147

<tr>

2752

3148

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

2760

3156

<tr>

2761

3157

2762

3158

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

2763

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>

2764

3160

</td>

2765

3161

</tr>

2766

3162

</tbody>

2782

3178

<code>closure</code>. Usually, this function will be called on closures that

2783

3179

use this <code>object</code> as closure data.

2784

3180

2785

3181

3182

2786

3183

3184

<col>

3185

</colgroup>

2787

3186

<tbody>

2788

3187

<tr>

2789

3188

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

2808

3207

2809

3208

This functions should only be called from object system implementations.

2810

3209

2811

3210

3211

2812

3212

3213

<col>

3214

</colgroup>

2813

3215

2814

3216

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

2815

3217

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

2825

3227

This macro should be used to emit a standard warning about unexpected

2826

3228

properties in <code class="function">set_property()</code> and <code class="function">get_property()</code> implementations.

2827

3229

2828

3230

3231

2829

3232

3233

<col>

3234

</colgroup>

2830

3235

<tbody>

2831

3236

<tr>

2832

3237

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

2851

3256

</pre>

2852

3257

2853

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

2854

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

2855

3260

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

2856

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>

2857

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

2858

3263

2859

3264

2860

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

2869

3274

2870

3275

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

2871

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

2872

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

2873

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

2874

3279

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

2875

3280

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

2879

3284

2880

3285

2881

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

2882

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

2883

3288

2884

3289

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

2885

3290

2893

3298

<a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> in static storage because it will already be

2894

3299

properly initialised. Just use <a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-set" title="g_weak_ref_set ()"><code class="function">g_weak_ref_set()</code></a> directly.

2895

3300

2896

3301

3302

2897

3303

3304

<col>

3305

</colgroup>

2898

3306

<tbody>

2899

3307

<tr>

2900

3308

2904

3312

</tr>

2905

3313

<tr>

2906

3314

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

2907

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

2908

3316

</td>

2909

3317

</tr>

2910

3318

</tbody>

2923

3331

You should only call this on a <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef">GWeakRef</a> that previously had

2924

3332

<a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-init" title="g_weak_ref_init ()"><code class="function">g_weak_ref_init()</code></a> called on it.

2925

3333

2926

3334

3335

2927

3336

3337

<col>

3338

</colgroup>

2928

3339

2929

3340

2930

3341

<td>location of a weak reference, which

2937

3348

<hr>

2938

3349

2939

3350

2940

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

2941

3352

2942

3353

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

2943

3354

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

2951

3362

The caller should release the resulting reference in the usual way,

2952

3363

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

2953

3364

2954

3365

3366

2955

3367

3368

<col>

3369

</colgroup>

2956

3370

<tbody>

2957

3371

<tr>

2958

3372

2962

3376

<tr>

2963

3377

<td>Returns :</td>

2964

3378

<td>the object pointed to

2965

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]

2966

3380

</td>

2967

3381

</tr>

2968

3382

</tbody>

2973

3387

2974

3388

2975

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

2976

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

2977

3391

2978

3392

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

2979

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

2980

3394

2981

3395

2982

3396

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

2983

3397

function.

2984

3398

2985

3399

3400

2986

3401

3402

<col>

3403

</colgroup>

2987

3404

<tbody>

2988

3405

<tr>

2989

3406

2991

3408

</tr>

2992

3409

<tr>

2993

3410

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

2994

3411

2995

3412

</td>

2996

3413

</tr>

2997

3414

</tbody>

3005

3422

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

3006

3423

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

3007

3424

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

3008

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

3009

3426

3010

3427

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

3011

3428

properties has been changed. Note that getting this signal

3018

3435

single property, by specifying the property name as a detail in the

3019

3436

<a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()"><code class="function">g_signal_connect()</code></a> call, like this:

3020

3437

3021

3022

g_signal_connect (text_view->buffer, "notify::paste-target-list",

3023

G_CALLBACK (gtk_text_view_target_list_notify),

3024

text_view)

3025

</pre></div>

3438

3439

3440

<tbody>

3441

<tr>

3442

<td class="listing_lines" align="right"><pre>1

3443

3444

3</pre></td>

3445

<td class="listing_code"><pre class="programlisting">g_signal_connect (text_view->buffer, "notify::paste-target-list",

3446

G_CALLBACK (gtk_text_view_target_list_notify),

3447

text_view)</pre></td>

3448

</tr>

3449

</tbody>

3450

</table>

3451

</div>

3452

3026

3453

3027

3454

It is important to note that you must use

3028

3455

<a class="link" href="gobject-GParamSpec.html#canonical-parameter-name">canonical</a> parameter names as

3029

3456

detail strings for the notify signal.

3030

3457

3031

3458

3459

3032

3460

3461

<col>

3462

</colgroup>

3033

3463

<tbody>

3034

3464

<tr>

3035

3465

<td><code>gobject</code> :</td>

3054

3484

</div>

3055

3485

3056

3486

<hr>

3057

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

3487

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

3058

3488

</body>

3059

3489

</html>

b'\\ No newline at end of file'

Older »