luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-02-26 12:12:10 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add an example

Browse Source
This commit is contained in:
Matthias Clasen 2005-07-05 05:54:42 +00:00
parent 25f745709d
commit f77e7d1272
2 changed files with 31 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/reference/ChangeLog
View File

@ -1,3 +1,8 @@
2005-07-05 Matthias Clasen <mclasen@redhat.com>
* gobject/tmpl/objects.sgml: Add an example
for using a custom constructor.
2005-06-30 Matthias Clasen <mclasen@redhat.com> 2005-06-30 Matthias Clasen <mclasen@redhat.com>
* === Released 2.7.1 === * === Released 2.7.1 ===

30
docs/reference/gobject/tmpl/objects.sgml
View File

@ -17,9 +17,6 @@ Signals are described in detail in <xref linkend="gobject-Signals"/>.
#GParamSpecObject, g_param_spec_object() #GParamSpecObject, g_param_spec_object()
</para> </para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GObject ##### --> <!-- ##### STRUCT GObject ##### -->
<para> <para>
All the fields in the <structname>GObject</structname> structure are private All the fields in the <structname>GObject</structname> structure are private
@ -42,13 +39,38 @@ the setter for the property is called to reinstate the previous value.
<para> <para>
The class structure for the <structname>GObject</structname> type. The class structure for the <structname>GObject</structname> type.
</para> </para>
<example>
<title>Implementing singletons using a constructor</title>
<programlisting>
static MySingleton *the_singleton = NULL;
static GObject*
my_singleton_constructor (GType type,
guint n_construct_params,
GObjectConstructParam *construct_params)
{
GObject *object;
if (!the_singleton)
{
object = G_OBJECT_CLASS (parent_class)->constructor (type,
n_construct_params,
construct_params);
the_singleton = MY_SINGLETON (object);
}
else
object = g_object_ref (G_OBJECT (the_singleton));
return object;
}
</programlisting></example>
@g_type_class: the parent class @g_type_class: the parent class
@constructor: the @constructor function is called by g_object_new () to @constructor: the @constructor function is called by g_object_new () to
complete the object initialization after all the construction properties are complete the object initialization after all the construction properties are
set. The first thing a @constructor implementation must do is chain up to the set. The first thing a @constructor implementation must do is chain up to the
@constructor of the parent class. Overriding @constructor should be rarely @constructor of the parent class. Overriding @constructor should be rarely
needed. needed, e.g. to handle construct properties, or to implement singletons.
@set_property: the generic setter for all properties of this type. Should be @set_property: the generic setter for all properties of this type. Should be
overridden for every type with properties. Implementations of @set_property overridden for every type with properties. Implementations of @set_property
don't need to emit property change notification explicitly, this is handled don't need to emit property change notification explicitly, this is handled