1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
/* doc-examples-obj.c */
#include "doc-examples-obj.h"
/**
* DocExamplesObj:
*
* This is an example of how to document a class
*
* This class has a signal: #DocExamplesObj::signal-example.
*
* And also has a property: #DocExamplesObj:property-example.
*
* Since: 0.99
*/
G_DEFINE_TYPE (DocExamplesObj, doc_examples_obj, G_TYPE_OBJECT)
static void
doc_examples_obj_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec)
{
switch (property_id)
{
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
}
}
static void
doc_examples_obj_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec)
{
switch (property_id)
{
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
}
}
static void
doc_examples_obj_class_init (DocExamplesObjClass *klass)
{
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
GParamSpec *pspec;
gobject_class->get_property = doc_examples_obj_get_property;
gobject_class->set_property = doc_examples_obj_set_property;
/**
* DocExamplesObj::signal-example:
* @object:
* @int_param: a parameter of type int
* @float_param: a parameter of type float
*
* Emitted when the connection status on the account changes.
*
* The @dbus_error_name and @details parameters were present, but
* non-functional (always %NULL), in older versions. They have been
* available with their current behaviour since version 0.11.7.
*
* Since: 0.99
*/
g_signal_new ("signal-example",
G_TYPE_FROM_CLASS (gobject_class),
G_SIGNAL_RUN_LAST,
0, NULL, NULL,
NULL,
G_TYPE_NONE, 2, G_TYPE_UINT, G_TYPE_UINT);
/**
* DocExamplesObj:property-example:
*
* This is an example of how to document a property.
*
* Type: GLib.HashTable(utf8,gint8)
* Transfer: container
*/
pspec = g_param_spec_boxed ("property-example",
"Example property",
"A contained GHashTable",
G_TYPE_HASH_TABLE,
G_PARAM_READWRITE);
g_object_class_install_property (gobject_class,
1,
pspec);
}
static void
doc_examples_obj_init (DocExamplesObj *self)
{
}
DocExamplesObj *
doc_examples_obj_new (void)
{
return g_object_new (DOC_EXAMPLES_TYPE_OBJ, NULL);
}
|