~ubuntu-branches/ubuntu/utopic/glib2.0/utopic
» Revision
1.2.21
: docs/reference/gobject/html/gobject-Standard-Parameter-and-Value-Types.html
« back to all changes in this revision
Viewing changes to docs/reference/gobject/html/gobject-Standard-Parameter-and-Value-Types.html
- browse files at revision 1.2.21
- compare with another revision
- download diff
- download tarball
- view history from revision 1.2.21
- Committer: Bazaar Package Importer
- Author(s): Sebastien Bacher
- Date: 2007-05-04 10:55:02 UTC
- mto: (3.2.1 intrepid) (1.6.1 upstream) (157.1.1 precise-proposed) (162.1.1 quantal) (172.1.1 experimental) (185.1.1 raring-proposed)
- mto: This revision was merged to the branch mainline in revision 4.
- Revision ID: james.westby@ubuntu.com-20070504105502-izybnh9z2nprjlk6
Tags: upstream-2.12.12
Import upstream version 2.12.12
- files added:
- AUTHORS
- build
- build/win32
- build/win32/dirent
- build/win32/vs8
- docs
- docs/reference
- docs/reference/glib
- docs/reference/glib/html
- docs/reference/glib/tmpl
- docs/reference/glib/xml
- docs/reference/gobject
- docs/reference/gobject/html
- docs/reference/gobject/images
- docs/reference/gobject/tmpl
- docs/reference/gobject/xml
- glib
- glib/glib-mirroring-tab
- glib/gnulib
- glib/libcharset
- gmodule
- gobject
- gthread
- m4macros
- po
- tests
- tests/bookmarks
- tests/collate
- tests/gobject
- tests/markups
- tests/refcount
- files removed:
- upstream
- upstream/tarballs
added
removed
docs/reference/gobject/html/gobject-Standard-Parameter-and-Value-Types.html
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html>
3
<head>
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>Parameters and Values</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
<link rel="start" href="index.html" title="GObject Reference Manual">
8
<link rel="up" href="rn01.html" title="API Reference">
9
<link rel="prev" href="gobject-Generic-values.html" title="Generic Values">
10
<link rel="next" href="gobject-Varargs-Value-Collection.html" title="Varargs Value Collection">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="preface" href="pr01.html" title="Introduction">
14
<link rel="part" href="pt01.html" title="Part I. Concepts">
15
<link rel="chapter" href="ch01.html" title="Background">
16
<link rel="chapter" href="ch02.html" title="The Glib Dynamic Type System">
17
<link rel="chapter" href="chapter-gobject.html" title="The GObject base class">
18
<link rel="chapter" href="chapter-signal.html" title="The GObject messaging system">
19
<link rel="reference" href="rn01.html" title="API Reference">
20
<link rel="reference" href="rn02.html" title="Tools Reference">
21
<link rel="part" href="pt02.html" title="Part IV. Tutorial">
22
<link rel="chapter" href="howto-gobject.html" title="How To define and implement a new GObject?">
23
<link rel="chapter" href="howto-interface.html" title="How To define and implement Interfaces?">
24
<link rel="chapter" href="howto-signals.html" title="Howto create and use signals">
25
<link rel="part" href="pt03.html" title="Part V. Related Tools">
26
<link rel="chapter" href="tools-gob.html" title="GObject builder">
27
<link rel="chapter" href="tools-ginspector.html" title="Graphical inspection of Gobjects">
28
<link rel="chapter" href="tools-refdb.html" title="Debugging reference count problems">
29
<link rel="chapter" href="tools-gtkdoc.html" title="Writing API docs">
30
<link rel="index" href="ix01.html" title="Index">
31
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
32
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
33
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
34
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
35
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
36
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
37
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
38
</head>
39
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
40
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
41
<tr valign="middle">
42
<td><a accesskey="p" href="gobject-Generic-values.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
43
<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
44
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
45
<th width="100%" align="center">GObject Reference Manual</th>
46
<td><a accesskey="n" href="gobject-Varargs-Value-Collection.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
47
</tr>
48
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3094195" class="shortcut">Top</a>
49
 | 
50
<a href="#id3097962" class="shortcut">Description</a></nobr></td></tr>
51
</table>
52
<div class="refentry" lang="en">
53
<a name="gobject-Standard-Parameter-and-Value-Types"></a><div class="titlepage"></div>
54
<div class="refnamediv"><table width="100%"><tr>
55
<td valign="top">
56
<h2>
57
<a name="id3094195"></a><span class="refentrytitle">Parameters and Values</span>
58
</h2>
59
<p>Parameters and Values — Standard Parameter and Value Types</p>
60
</td>
61
<td valign="top" align="right"></td>
62
</tr></table></div>
63
<div class="refsynopsisdiv">
64
<h2>Synopsis</h2>
65
<pre class="synopsis">
66
67
#include <glib-object.h>
68
69
70
71
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-BOOLEAN:CAPS">G_IS_PARAM_SPEC_BOOLEAN</a> (pspec)
72
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-BOOLEAN:CAPS">G_PARAM_SPEC_BOOLEAN</a> (pspec)
73
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-BOOLEAN:CAPS">G_VALUE_HOLDS_BOOLEAN</a> (value)
74
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-BOOLEAN:CAPS">G_TYPE_PARAM_BOOLEAN</a>
75
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoolean">GParamSpecBoolean</a>;
76
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-boolean">g_param_spec_boolean</a> (const <a
77
href="../glib/glib-Basic-Types.html#gchar"
78
>gchar</a> *name,
79
const <a
80
href="../glib/glib-Basic-Types.html#gchar"
81
>gchar</a> *nick,
82
const <a
83
href="../glib/glib-Basic-Types.html#gchar"
84
>gchar</a> *blurb,
85
<a
86
href="../glib/glib-Basic-Types.html#gboolean"
87
>gboolean</a> default_value,
88
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
89
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-boolean">g_value_set_boolean</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
90
<a
91
href="../glib/glib-Basic-Types.html#gboolean"
92
>gboolean</a> v_boolean);
93
<a
94
href="../glib/glib-Basic-Types.html#gboolean"
95
>gboolean</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-boolean">g_value_get_boolean</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
96
97
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-CHAR:CAPS">G_IS_PARAM_SPEC_CHAR</a> (pspec)
98
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-CHAR:CAPS">G_PARAM_SPEC_CHAR</a> (pspec)
99
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-CHAR:CAPS">G_VALUE_HOLDS_CHAR</a> (value)
100
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-CHAR:CAPS">G_TYPE_PARAM_CHAR</a>
101
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecChar">GParamSpecChar</a>;
102
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-char">g_param_spec_char</a> (const <a
103
href="../glib/glib-Basic-Types.html#gchar"
104
>gchar</a> *name,
105
const <a
106
href="../glib/glib-Basic-Types.html#gchar"
107
>gchar</a> *nick,
108
const <a
109
href="../glib/glib-Basic-Types.html#gchar"
110
>gchar</a> *blurb,
111
<a
112
href="../glib/glib-Basic-Types.html#gint8"
113
>gint8</a> minimum,
114
<a
115
href="../glib/glib-Basic-Types.html#gint8"
116
>gint8</a> maximum,
117
<a
118
href="../glib/glib-Basic-Types.html#gint8"
119
>gint8</a> default_value,
120
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
121
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-char">g_value_set_char</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
122
<a
123
href="../glib/glib-Basic-Types.html#gchar"
124
>gchar</a> v_char);
125
<a
126
href="../glib/glib-Basic-Types.html#gchar"
127
>gchar</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-char">g_value_get_char</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
128
129
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-UCHAR:CAPS">G_IS_PARAM_SPEC_UCHAR</a> (pspec)
130
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-UCHAR:CAPS">G_PARAM_SPEC_UCHAR</a> (pspec)
131
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-UCHAR:CAPS">G_VALUE_HOLDS_UCHAR</a> (value)
132
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UCHAR:CAPS">G_TYPE_PARAM_UCHAR</a>
133
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUChar">GParamSpecUChar</a>;
134
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-uchar">g_param_spec_uchar</a> (const <a
135
href="../glib/glib-Basic-Types.html#gchar"
136
>gchar</a> *name,
137
const <a
138
href="../glib/glib-Basic-Types.html#gchar"
139
>gchar</a> *nick,
140
const <a
141
href="../glib/glib-Basic-Types.html#gchar"
142
>gchar</a> *blurb,
143
<a
144
href="../glib/glib-Basic-Types.html#guint8"
145
>guint8</a> minimum,
146
<a
147
href="../glib/glib-Basic-Types.html#guint8"
148
>guint8</a> maximum,
149
<a
150
href="../glib/glib-Basic-Types.html#guint8"
151
>guint8</a> default_value,
152
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
153
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-uchar">g_value_set_uchar</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
154
<a
155
href="../glib/glib-Basic-Types.html#guchar"
156
>guchar</a> v_uchar);
157
<a
158
href="../glib/glib-Basic-Types.html#guchar"
159
>guchar</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-uchar">g_value_get_uchar</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
160
161
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-INT:CAPS">G_IS_PARAM_SPEC_INT</a> (pspec)
162
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-INT:CAPS">G_PARAM_SPEC_INT</a> (pspec)
163
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-INT:CAPS">G_VALUE_HOLDS_INT</a> (value)
164
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-INT:CAPS">G_TYPE_PARAM_INT</a>
165
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt">GParamSpecInt</a>;
166
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-int">g_param_spec_int</a> (const <a
167
href="../glib/glib-Basic-Types.html#gchar"
168
>gchar</a> *name,
169
const <a
170
href="../glib/glib-Basic-Types.html#gchar"
171
>gchar</a> *nick,
172
const <a
173
href="../glib/glib-Basic-Types.html#gchar"
174
>gchar</a> *blurb,
175
<a
176
href="../glib/glib-Basic-Types.html#gint"
177
>gint</a> minimum,
178
<a
179
href="../glib/glib-Basic-Types.html#gint"
180
>gint</a> maximum,
181
<a
182
href="../glib/glib-Basic-Types.html#gint"
183
>gint</a> default_value,
184
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
185
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-int">g_value_set_int</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
186
<a
187
href="../glib/glib-Basic-Types.html#gint"
188
>gint</a> v_int);
189
<a
190
href="../glib/glib-Basic-Types.html#gint"
191
>gint</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-int">g_value_get_int</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
192
193
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-UINT:CAPS">G_IS_PARAM_SPEC_UINT</a> (pspec)
194
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-UINT:CAPS">G_PARAM_SPEC_UINT</a> (pspec)
195
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-UINT:CAPS">G_VALUE_HOLDS_UINT</a> (value)
196
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UINT:CAPS">G_TYPE_PARAM_UINT</a>
197
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt">GParamSpecUInt</a>;
198
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-uint">g_param_spec_uint</a> (const <a
199
href="../glib/glib-Basic-Types.html#gchar"
200
>gchar</a> *name,
201
const <a
202
href="../glib/glib-Basic-Types.html#gchar"
203
>gchar</a> *nick,
204
const <a
205
href="../glib/glib-Basic-Types.html#gchar"
206
>gchar</a> *blurb,
207
<a
208
href="../glib/glib-Basic-Types.html#guint"
209
>guint</a> minimum,
210
<a
211
href="../glib/glib-Basic-Types.html#guint"
212
>guint</a> maximum,
213
<a
214
href="../glib/glib-Basic-Types.html#guint"
215
>guint</a> default_value,
216
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
217
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-uint">g_value_set_uint</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
218
<a
219
href="../glib/glib-Basic-Types.html#guint"
220
>guint</a> v_uint);
221
<a
222
href="../glib/glib-Basic-Types.html#guint"
223
>guint</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-uint">g_value_get_uint</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
224
225
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-LONG:CAPS">G_IS_PARAM_SPEC_LONG</a> (pspec)
226
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-LONG:CAPS">G_PARAM_SPEC_LONG</a> (pspec)
227
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-LONG:CAPS">G_VALUE_HOLDS_LONG</a> (value)
228
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-LONG:CAPS">G_TYPE_PARAM_LONG</a>
229
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecLong">GParamSpecLong</a>;
230
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-long">g_param_spec_long</a> (const <a
231
href="../glib/glib-Basic-Types.html#gchar"
232
>gchar</a> *name,
233
const <a
234
href="../glib/glib-Basic-Types.html#gchar"
235
>gchar</a> *nick,
236
const <a
237
href="../glib/glib-Basic-Types.html#gchar"
238
>gchar</a> *blurb,
239
<a
240
href="../glib/glib-Basic-Types.html#glong"
241
>glong</a> minimum,
242
<a
243
href="../glib/glib-Basic-Types.html#glong"
244
>glong</a> maximum,
245
<a
246
href="../glib/glib-Basic-Types.html#glong"
247
>glong</a> default_value,
248
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
249
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-long">g_value_set_long</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
250
<a
251
href="../glib/glib-Basic-Types.html#glong"
252
>glong</a> v_long);
253
<a
254
href="../glib/glib-Basic-Types.html#glong"
255
>glong</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-long">g_value_get_long</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
256
257
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-ULONG:CAPS">G_IS_PARAM_SPEC_ULONG</a> (pspec)
258
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-ULONG:CAPS">G_PARAM_SPEC_ULONG</a> (pspec)
259
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-ULONG:CAPS">G_VALUE_HOLDS_ULONG</a> (value)
260
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-ULONG:CAPS">G_TYPE_PARAM_ULONG</a>
261
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecULong">GParamSpecULong</a>;
262
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-ulong">g_param_spec_ulong</a> (const <a
263
href="../glib/glib-Basic-Types.html#gchar"
264
>gchar</a> *name,
265
const <a
266
href="../glib/glib-Basic-Types.html#gchar"
267
>gchar</a> *nick,
268
const <a
269
href="../glib/glib-Basic-Types.html#gchar"
270
>gchar</a> *blurb,
271
<a
272
href="../glib/glib-Basic-Types.html#gulong"
273
>gulong</a> minimum,
274
<a
275
href="../glib/glib-Basic-Types.html#gulong"
276
>gulong</a> maximum,
277
<a
278
href="../glib/glib-Basic-Types.html#gulong"
279
>gulong</a> default_value,
280
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
281
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-ulong">g_value_set_ulong</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
282
<a
283
href="../glib/glib-Basic-Types.html#gulong"
284
>gulong</a> v_ulong);
285
<a
286
href="../glib/glib-Basic-Types.html#gulong"
287
>gulong</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-ulong">g_value_get_ulong</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
288
289
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-INT64:CAPS">G_IS_PARAM_SPEC_INT64</a> (pspec)
290
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-INT64:CAPS">G_PARAM_SPEC_INT64</a> (pspec)
291
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-INT64:CAPS">G_VALUE_HOLDS_INT64</a> (value)
292
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-INT64:CAPS">G_TYPE_PARAM_INT64</a>
293
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt64">GParamSpecInt64</a>;
294
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-int64">g_param_spec_int64</a> (const <a
295
href="../glib/glib-Basic-Types.html#gchar"
296
>gchar</a> *name,
297
const <a
298
href="../glib/glib-Basic-Types.html#gchar"
299
>gchar</a> *nick,
300
const <a
301
href="../glib/glib-Basic-Types.html#gchar"
302
>gchar</a> *blurb,
303
<a
304
href="../glib/glib-Basic-Types.html#gint64"
305
>gint64</a> minimum,
306
<a
307
href="../glib/glib-Basic-Types.html#gint64"
308
>gint64</a> maximum,
309
<a
310
href="../glib/glib-Basic-Types.html#gint64"
311
>gint64</a> default_value,
312
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
313
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-int64">g_value_set_int64</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
314
<a
315
href="../glib/glib-Basic-Types.html#gint64"
316
>gint64</a> v_int64);
317
<a
318
href="../glib/glib-Basic-Types.html#gint64"
319
>gint64</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-int64">g_value_get_int64</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
320
321
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-UINT64:CAPS">G_IS_PARAM_SPEC_UINT64</a> (pspec)
322
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-UINT64:CAPS">G_PARAM_SPEC_UINT64</a> (pspec)
323
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-UINT64:CAPS">G_VALUE_HOLDS_UINT64</a> (value)
324
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UINT64:CAPS">G_TYPE_PARAM_UINT64</a>
325
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt64">GParamSpecUInt64</a>;
326
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-uint64">g_param_spec_uint64</a> (const <a
327
href="../glib/glib-Basic-Types.html#gchar"
328
>gchar</a> *name,
329
const <a
330
href="../glib/glib-Basic-Types.html#gchar"
331
>gchar</a> *nick,
332
const <a
333
href="../glib/glib-Basic-Types.html#gchar"
334
>gchar</a> *blurb,
335
<a
336
href="../glib/glib-Basic-Types.html#guint64"
337
>guint64</a> minimum,
338
<a
339
href="../glib/glib-Basic-Types.html#guint64"
340
>guint64</a> maximum,
341
<a
342
href="../glib/glib-Basic-Types.html#guint64"
343
>guint64</a> default_value,
344
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
345
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-uint64">g_value_set_uint64</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
346
<a
347
href="../glib/glib-Basic-Types.html#guint64"
348
>guint64</a> v_uint64);
349
<a
350
href="../glib/glib-Basic-Types.html#guint64"
351
>guint64</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-uint64">g_value_get_uint64</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
352
353
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-FLOAT:CAPS">G_IS_PARAM_SPEC_FLOAT</a> (pspec)
354
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-FLOAT:CAPS">G_PARAM_SPEC_FLOAT</a> (pspec)
355
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-FLOAT:CAPS">G_VALUE_HOLDS_FLOAT</a> (value)
356
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-FLOAT:CAPS">G_TYPE_PARAM_FLOAT</a>
357
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecFloat">GParamSpecFloat</a>;
358
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-float">g_param_spec_float</a> (const <a
359
href="../glib/glib-Basic-Types.html#gchar"
360
>gchar</a> *name,
361
const <a
362
href="../glib/glib-Basic-Types.html#gchar"
363
>gchar</a> *nick,
364
const <a
365
href="../glib/glib-Basic-Types.html#gchar"
366
>gchar</a> *blurb,
367
<a
368
href="../glib/glib-Basic-Types.html#gfloat"
369
>gfloat</a> minimum,
370
<a
371
href="../glib/glib-Basic-Types.html#gfloat"
372
>gfloat</a> maximum,
373
<a
374
href="../glib/glib-Basic-Types.html#gfloat"
375
>gfloat</a> default_value,
376
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
377
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-float">g_value_set_float</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
378
<a
379
href="../glib/glib-Basic-Types.html#gfloat"
380
>gfloat</a> v_float);
381
<a
382
href="../glib/glib-Basic-Types.html#gfloat"
383
>gfloat</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-float">g_value_get_float</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
384
385
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-DOUBLE:CAPS">G_IS_PARAM_SPEC_DOUBLE</a> (pspec)
386
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-DOUBLE:CAPS">G_PARAM_SPEC_DOUBLE</a> (pspec)
387
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-DOUBLE:CAPS">G_VALUE_HOLDS_DOUBLE</a> (value)
388
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-DOUBLE:CAPS">G_TYPE_PARAM_DOUBLE</a>
389
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecDouble">GParamSpecDouble</a>;
390
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-double">g_param_spec_double</a> (const <a
391
href="../glib/glib-Basic-Types.html#gchar"
392
>gchar</a> *name,
393
const <a
394
href="../glib/glib-Basic-Types.html#gchar"
395
>gchar</a> *nick,
396
const <a
397
href="../glib/glib-Basic-Types.html#gchar"
398
>gchar</a> *blurb,
399
<a
400
href="../glib/glib-Basic-Types.html#gdouble"
401
>gdouble</a> minimum,
402
<a
403
href="../glib/glib-Basic-Types.html#gdouble"
404
>gdouble</a> maximum,
405
<a
406
href="../glib/glib-Basic-Types.html#gdouble"
407
>gdouble</a> default_value,
408
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
409
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-double">g_value_set_double</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
410
<a
411
href="../glib/glib-Basic-Types.html#gdouble"
412
>gdouble</a> v_double);
413
<a
414
href="../glib/glib-Basic-Types.html#gdouble"
415
>gdouble</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-double">g_value_get_double</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
416
417
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-ENUM:CAPS">G_IS_PARAM_SPEC_ENUM</a> (pspec)
418
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-ENUM:CAPS">G_PARAM_SPEC_ENUM</a> (pspec)
419
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-ENUM:CAPS">G_VALUE_HOLDS_ENUM</a> (value)
420
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-ENUM:CAPS">G_TYPE_PARAM_ENUM</a>
421
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecEnum">GParamSpecEnum</a>;
422
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-enum">g_param_spec_enum</a> (const <a
423
href="../glib/glib-Basic-Types.html#gchar"
424
>gchar</a> *name,
425
const <a
426
href="../glib/glib-Basic-Types.html#gchar"
427
>gchar</a> *nick,
428
const <a
429
href="../glib/glib-Basic-Types.html#gchar"
430
>gchar</a> *blurb,
431
<a href="gobject-Type-Information.html#GType">GType</a> enum_type,
432
<a
433
href="../glib/glib-Basic-Types.html#gint"
434
>gint</a> default_value,
435
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
436
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-enum">g_value_set_enum</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
437
<a
438
href="../glib/glib-Basic-Types.html#gint"
439
>gint</a> v_enum);
440
<a
441
href="../glib/glib-Basic-Types.html#gint"
442
>gint</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-enum">g_value_get_enum</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
443
444
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-FLAGS:CAPS">G_IS_PARAM_SPEC_FLAGS</a> (pspec)
445
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-FLAGS:CAPS">G_PARAM_SPEC_FLAGS</a> (pspec)
446
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-FLAGS:CAPS">G_VALUE_HOLDS_FLAGS</a> (value)
447
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-FLAGS:CAPS">G_TYPE_PARAM_FLAGS</a>
448
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecFlags">GParamSpecFlags</a>;
449
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-flags">g_param_spec_flags</a> (const <a
450
href="../glib/glib-Basic-Types.html#gchar"
451
>gchar</a> *name,
452
const <a
453
href="../glib/glib-Basic-Types.html#gchar"
454
>gchar</a> *nick,
455
const <a
456
href="../glib/glib-Basic-Types.html#gchar"
457
>gchar</a> *blurb,
458
<a href="gobject-Type-Information.html#GType">GType</a> flags_type,
459
<a
460
href="../glib/glib-Basic-Types.html#guint"
461
>guint</a> default_value,
462
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
463
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-flags">g_value_set_flags</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
464
<a
465
href="../glib/glib-Basic-Types.html#guint"
466
>guint</a> v_flags);
467
<a
468
href="../glib/glib-Basic-Types.html#guint"
469
>guint</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-flags">g_value_get_flags</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
470
471
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-STRING:CAPS">G_IS_PARAM_SPEC_STRING</a> (pspec)
472
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-STRING:CAPS">G_PARAM_SPEC_STRING</a> (pspec)
473
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-STRING:CAPS">G_VALUE_HOLDS_STRING</a> (value)
474
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-STRING:CAPS">G_TYPE_PARAM_STRING</a>
475
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecString">GParamSpecString</a>;
476
typedef <a href="gobject-Standard-Parameter-and-Value-Types.html#gchararray">gchararray</a>;
477
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-string">g_param_spec_string</a> (const <a
478
href="../glib/glib-Basic-Types.html#gchar"
479
>gchar</a> *name,
480
const <a
481
href="../glib/glib-Basic-Types.html#gchar"
482
>gchar</a> *nick,
483
const <a
484
href="../glib/glib-Basic-Types.html#gchar"
485
>gchar</a> *blurb,
486
const <a
487
href="../glib/glib-Basic-Types.html#gchar"
488
>gchar</a> *default_value,
489
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
490
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-string">g_value_set_string</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
491
const <a
492
href="../glib/glib-Basic-Types.html#gchar"
493
>gchar</a> *v_string);
494
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-static-string">g_value_set_static_string</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
495
const <a
496
href="../glib/glib-Basic-Types.html#gchar"
497
>gchar</a> *v_string);
498
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-string">g_value_take_string</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
499
<a
500
href="../glib/glib-Basic-Types.html#gchar"
501
>gchar</a> *v_string);
502
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-string-take-ownership">g_value_set_string_take_ownership</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
503
<a
504
href="../glib/glib-Basic-Types.html#gchar"
505
>gchar</a> *v_string);
506
const <a
507
href="../glib/glib-Basic-Types.html#gchar"
508
>gchar</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-string">g_value_get_string</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
509
<a
510
href="../glib/glib-Basic-Types.html#gchar"
511
>gchar</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-dup-string">g_value_dup_string</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
512
513
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-PARAM:CAPS">G_IS_PARAM_SPEC_PARAM</a> (pspec)
514
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-PARAM:CAPS">G_PARAM_SPEC_PARAM</a> (pspec)
515
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-PARAM:CAPS">G_VALUE_HOLDS_PARAM</a> (value)
516
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-PARAM:CAPS">G_TYPE_PARAM_PARAM</a>
517
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecParam">GParamSpecParam</a>;
518
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-param">g_param_spec_param</a> (const <a
519
href="../glib/glib-Basic-Types.html#gchar"
520
>gchar</a> *name,
521
const <a
522
href="../glib/glib-Basic-Types.html#gchar"
523
>gchar</a> *nick,
524
const <a
525
href="../glib/glib-Basic-Types.html#gchar"
526
>gchar</a> *blurb,
527
<a href="gobject-Type-Information.html#GType">GType</a> param_type,
528
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
529
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-param">g_value_set_param</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
530
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *param);
531
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-param">g_value_take_param</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
532
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *param);
533
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-param-take-ownership">g_value_set_param_take_ownership</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
534
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *param);
535
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-param">g_value_get_param</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
536
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-dup-param">g_value_dup_param</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
537
538
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-BOXED:CAPS">G_IS_PARAM_SPEC_BOXED</a> (pspec)
539
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-BOXED:CAPS">G_PARAM_SPEC_BOXED</a> (pspec)
540
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-BOXED:CAPS">G_VALUE_HOLDS_BOXED</a> (value)
541
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-BOXED:CAPS">G_TYPE_PARAM_BOXED</a>
542
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoxed">GParamSpecBoxed</a>;
543
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-boxed">g_param_spec_boxed</a> (const <a
544
href="../glib/glib-Basic-Types.html#gchar"
545
>gchar</a> *name,
546
const <a
547
href="../glib/glib-Basic-Types.html#gchar"
548
>gchar</a> *nick,
549
const <a
550
href="../glib/glib-Basic-Types.html#gchar"
551
>gchar</a> *blurb,
552
<a href="gobject-Type-Information.html#GType">GType</a> boxed_type,
553
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
554
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-boxed">g_value_set_boxed</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
555
<a
556
href="../glib/glib-Basic-Types.html#gconstpointer"
557
>gconstpointer</a> v_boxed);
558
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-static-boxed">g_value_set_static_boxed</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
559
<a
560
href="../glib/glib-Basic-Types.html#gconstpointer"
561
>gconstpointer</a> v_boxed);
562
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-boxed">g_value_take_boxed</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
563
<a
564
href="../glib/glib-Basic-Types.html#gconstpointer"
565
>gconstpointer</a> v_boxed);
566
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-boxed-take-ownership">g_value_set_boxed_take_ownership</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
567
<a
568
href="../glib/glib-Basic-Types.html#gconstpointer"
569
>gconstpointer</a> v_boxed);
570
<a
571
href="../glib/glib-Basic-Types.html#gpointer"
572
>gpointer</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-boxed">g_value_get_boxed</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
573
<a
574
href="../glib/glib-Basic-Types.html#gpointer"
575
>gpointer</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-dup-boxed">g_value_dup_boxed</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
576
577
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-POINTER:CAPS">G_IS_PARAM_SPEC_POINTER</a> (pspec)
578
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-POINTER:CAPS">G_PARAM_SPEC_POINTER</a> (pspec)
579
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-POINTER:CAPS">G_VALUE_HOLDS_POINTER</a> (value)
580
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-POINTER:CAPS">G_TYPE_PARAM_POINTER</a>
581
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecPointer">GParamSpecPointer</a>;
582
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-pointer">g_param_spec_pointer</a> (const <a
583
href="../glib/glib-Basic-Types.html#gchar"
584
>gchar</a> *name,
585
const <a
586
href="../glib/glib-Basic-Types.html#gchar"
587
>gchar</a> *nick,
588
const <a
589
href="../glib/glib-Basic-Types.html#gchar"
590
>gchar</a> *blurb,
591
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
592
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-pointer">g_value_set_pointer</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
593
<a
594
href="../glib/glib-Basic-Types.html#gpointer"
595
>gpointer</a> v_pointer);
596
<a
597
href="../glib/glib-Basic-Types.html#gpointer"
598
>gpointer</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-pointer">g_value_get_pointer</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
599
600
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-OBJECT:CAPS">G_IS_PARAM_SPEC_OBJECT</a> (pspec)
601
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-OBJECT:CAPS">G_PARAM_SPEC_OBJECT</a> (pspec)
602
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-OBJECT:CAPS">G_VALUE_HOLDS_OBJECT</a> (value)
603
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-OBJECT:CAPS">G_TYPE_PARAM_OBJECT</a>
604
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecObject">GParamSpecObject</a>;
605
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-object">g_param_spec_object</a> (const <a
606
href="../glib/glib-Basic-Types.html#gchar"
607
>gchar</a> *name,
608
const <a
609
href="../glib/glib-Basic-Types.html#gchar"
610
>gchar</a> *nick,
611
const <a
612
href="../glib/glib-Basic-Types.html#gchar"
613
>gchar</a> *blurb,
614
<a href="gobject-Type-Information.html#GType">GType</a> object_type,
615
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
616
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-object">g_value_set_object</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
617
<a
618
href="../glib/glib-Basic-Types.html#gpointer"
619
>gpointer</a> v_object);
620
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-object">g_value_take_object</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
621
<a
622
href="../glib/glib-Basic-Types.html#gpointer"
623
>gpointer</a> v_object);
624
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-object-take-ownership">g_value_set_object_take_ownership</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
625
<a
626
href="../glib/glib-Basic-Types.html#gpointer"
627
>gpointer</a> v_object);
628
<a
629
href="../glib/glib-Basic-Types.html#gpointer"
630
>gpointer</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-object">g_value_get_object</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
631
<a href="gobject-The-Base-Object-Type.html#GObject">GObject</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-dup-object">g_value_dup_object</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
632
633
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-UNICHAR:CAPS">G_IS_PARAM_SPEC_UNICHAR</a> (pspec)
634
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-UNICHAR:CAPS">G_PARAM_SPEC_UNICHAR</a> (pspec)
635
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UNICHAR:CAPS">G_TYPE_PARAM_UNICHAR</a>
636
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUnichar">GParamSpecUnichar</a>;
637
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-unichar">g_param_spec_unichar</a> (const <a
638
href="../glib/glib-Basic-Types.html#gchar"
639
>gchar</a> *name,
640
const <a
641
href="../glib/glib-Basic-Types.html#gchar"
642
>gchar</a> *nick,
643
const <a
644
href="../glib/glib-Basic-Types.html#gchar"
645
>gchar</a> *blurb,
646
<a
647
href="../glib/glib-Unicode-Manipulation.html#gunichar"
648
>gunichar</a> default_value,
649
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
650
651
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-VALUE-ARRAY:CAPS">G_IS_PARAM_SPEC_VALUE_ARRAY</a> (pspec)
652
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-VALUE-ARRAY:CAPS">G_PARAM_SPEC_VALUE_ARRAY</a> (pspec)
653
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-VALUE-ARRAY:CAPS">G_TYPE_PARAM_VALUE_ARRAY</a>
654
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecValueArray">GParamSpecValueArray</a>;
655
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-value-array">g_param_spec_value_array</a> (const <a
656
href="../glib/glib-Basic-Types.html#gchar"
657
>gchar</a> *name,
658
const <a
659
href="../glib/glib-Basic-Types.html#gchar"
660
>gchar</a> *nick,
661
const <a
662
href="../glib/glib-Basic-Types.html#gchar"
663
>gchar</a> *blurb,
664
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *element_spec,
665
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
666
667
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-OVERRIDE:CAPS">G_IS_PARAM_SPEC_OVERRIDE</a> (pspec)
668
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-OVERRIDE:CAPS">G_PARAM_SPEC_OVERRIDE</a> (pspec)
669
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-OVERRIDE:CAPS">G_TYPE_PARAM_OVERRIDE</a>
670
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecOverride">GParamSpecOverride</a>;
671
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-override">g_param_spec_override</a> (const <a
672
href="../glib/glib-Basic-Types.html#gchar"
673
>gchar</a> *name,
674
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *overridden);
675
676
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-IS-PARAM-SPEC-GTYPE:CAPS">G_IS_PARAM_SPEC_GTYPE</a> (pspec)
677
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-PARAM-SPEC-GTYPE:CAPS">G_PARAM_SPEC_GTYPE</a> (pspec)
678
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-VALUE-HOLDS-GTYPE:CAPS">G_VALUE_HOLDS_GTYPE</a> (value)
679
#define <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-GTYPE:CAPS">G_TYPE_PARAM_GTYPE</a>
680
<a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecGType">GParamSpecGType</a>;
681
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* <a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-gtype">g_param_spec_gtype</a> (const <a
682
href="../glib/glib-Basic-Types.html#gchar"
683
>gchar</a> *name,
684
const <a
685
href="../glib/glib-Basic-Types.html#gchar"
686
>gchar</a> *nick,
687
const <a
688
href="../glib/glib-Basic-Types.html#gchar"
689
>gchar</a> *blurb,
690
<a href="gobject-Type-Information.html#GType">GType</a> is_a_type,
691
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);
692
<a href="gobject-Type-Information.html#GType">GType</a> <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-gtype">g_value_get_gtype</a> (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);
693
void <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-gtype">g_value_set_gtype</a> (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
694
<a href="gobject-Type-Information.html#GType">GType</a> v_gtype);
695
696
</pre>
697
</div>
698
<div class="refsect1" lang="en">
699
<a name="id3097962"></a><h2>Description</h2>
700
<p>
701
<a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> provides an abstract container structure which can be copied,
702
transformed and compared while holding a value of any (derived) type, which
703
is registered as a <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> with a <a href="gobject-Type-Information.html#GTypeValueTable"><span class="type">GTypeValueTable</span></a> in its <a href="gobject-Type-Information.html#GTypeInfo"><span class="type">GTypeInfo</span></a> structure.
704
Parameter specifications for most value types can be created as
705
<a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived instances, to implement e.g. <a href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> properties which
706
operate on <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containers.
707
</p>
708
<p>
709
Parameter names need to start with a letter (a-z or A-Z). Subsequent
710
characters can be letters, numbers or a '-'.
711
All other characters are replaced by a '-' during construction.
712
</p>
713
</div>
714
<div class="refsect1" lang="en">
715
<a name="id3098043"></a><h2>Details</h2>
716
<div class="refsect2" lang="en">
717
<a name="id3098053"></a><h3>
718
<a name="G-IS-PARAM-SPEC-BOOLEAN:CAPS"></a>G_IS_PARAM_SPEC_BOOLEAN()</h3>
719
<a class="indexterm" name="id3098067"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_BOOLEAN(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOOLEAN))
720
</pre>
721
<p>
722
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-BOOLEAN:CAPS"><code class="literal">G_TYPE_PARAM_BOOLEAN</code></a>.
723
</p>
724
<div class="variablelist"><table border="0">
725
<col align="left" valign="top">
726
<tbody><tr>
727
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
728
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
729
730
731
</td>
732
</tr></tbody>
733
</table></div>
734
</div>
735
<hr>
736
<div class="refsect2" lang="en">
737
<a name="id3098129"></a><h3>
738
<a name="G-PARAM-SPEC-BOOLEAN:CAPS"></a>G_PARAM_SPEC_BOOLEAN()</h3>
739
<a class="indexterm" name="id3098142"></a><pre class="programlisting">#define G_PARAM_SPEC_BOOLEAN(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOOLEAN, GParamSpecBoolean))
740
</pre>
741
<p>
742
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoolean"><span class="type">GParamSpecBoolean</span></a>.
743
</p>
744
<div class="variablelist"><table border="0">
745
<col align="left" valign="top">
746
<tbody><tr>
747
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
748
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
749
750
751
</td>
752
</tr></tbody>
753
</table></div>
754
</div>
755
<hr>
756
<div class="refsect2" lang="en">
757
<a name="id3098202"></a><h3>
758
<a name="G-VALUE-HOLDS-BOOLEAN:CAPS"></a>G_VALUE_HOLDS_BOOLEAN()</h3>
759
<a class="indexterm" name="id3098215"></a><pre class="programlisting">#define G_VALUE_HOLDS_BOOLEAN(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOOLEAN))
760
</pre>
761
<p>
762
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>.
763
</p>
764
<div class="variablelist"><table border="0">
765
<col align="left" valign="top">
766
<tbody><tr>
767
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
768
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
769
770
771
</td>
772
</tr></tbody>
773
</table></div>
774
</div>
775
<hr>
776
<div class="refsect2" lang="en">
777
<a name="id3098277"></a><h3>
778
<a name="G-TYPE-PARAM-BOOLEAN:CAPS"></a>G_TYPE_PARAM_BOOLEAN</h3>
779
<a class="indexterm" name="id3098290"></a><pre class="programlisting">#define G_TYPE_PARAM_BOOLEAN (g_param_spec_types[2])
780
</pre>
781
<p>
782
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoolean"><span class="type">GParamSpecBoolean</span></a>.
783
</p>
784
</div>
785
<hr>
786
<div class="refsect2" lang="en">
787
<a name="id3098322"></a><h3>
788
<a name="GParamSpecBoolean"></a>GParamSpecBoolean</h3>
789
<a class="indexterm" name="id3098335"></a><pre class="programlisting">typedef struct {
790
GParamSpec parent_instance;
791
792
gboolean default_value;
793
} GParamSpecBoolean;
794
</pre>
795
<p>
796
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for boolean properties.
797
</p>
798
<div class="variablelist"><table border="0">
799
<col align="left" valign="top">
800
<tbody>
801
<tr>
802
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
803
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
804
</td>
805
</tr>
806
<tr>
807
<td><span class="term"><a
808
href="../glib/glib-Basic-Types.html#gboolean"
809
>gboolean</a> <em class="structfield"><code>default_value</code></em>;</span></td>
810
<td> default value for the property specified
811
812
</td>
813
</tr>
814
</tbody>
815
</table></div>
816
</div>
817
<hr>
818
<div class="refsect2" lang="en">
819
<a name="id3098414"></a><h3>
820
<a name="g-param-spec-boolean"></a>g_param_spec_boolean ()</h3>
821
<a class="indexterm" name="id3098428"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_boolean (const <a
822
href="../glib/glib-Basic-Types.html#gchar"
823
>gchar</a> *name,
824
const <a
825
href="../glib/glib-Basic-Types.html#gchar"
826
>gchar</a> *nick,
827
const <a
828
href="../glib/glib-Basic-Types.html#gchar"
829
>gchar</a> *blurb,
830
<a
831
href="../glib/glib-Basic-Types.html#gboolean"
832
>gboolean</a> default_value,
833
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
834
<p>
835
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoolean"><span class="type">GParamSpecBoolean</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>
836
property.
837
</p>
838
<p>
839
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
840
</p>
841
<div class="variablelist"><table border="0">
842
<col align="left" valign="top">
843
<tbody>
844
<tr>
845
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
846
<td> canonical name of the property specified
847
</td>
848
</tr>
849
<tr>
850
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
851
<td> nick name for the property specified
852
</td>
853
</tr>
854
<tr>
855
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
856
<td> description of the property specified
857
</td>
858
</tr>
859
<tr>
860
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
861
<td>default value for the property specified
862
</td>
863
</tr>
864
<tr>
865
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
866
<td> flags for the property specified
867
</td>
868
</tr>
869
<tr>
870
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
871
<td>a newly created parameter specification
872
873
874
</td>
875
</tr>
876
</tbody>
877
</table></div>
878
</div>
879
<hr>
880
<div class="refsect2" lang="en">
881
<a name="id3098611"></a><h3>
882
<a name="g-value-set-boolean"></a>g_value_set_boolean ()</h3>
883
<a class="indexterm" name="id3098624"></a><pre class="programlisting">void g_value_set_boolean (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
884
<a
885
href="../glib/glib-Basic-Types.html#gboolean"
886
>gboolean</a> v_boolean);</pre>
887
<p>
888
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_boolean</code></em>.
889
</p>
890
<div class="variablelist"><table border="0">
891
<col align="left" valign="top">
892
<tbody>
893
<tr>
894
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
895
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>
896
</td>
897
</tr>
898
<tr>
899
<td><span class="term"><em class="parameter"><code>v_boolean</code></em> :</span></td>
900
<td>boolean value to be set
901
902
903
</td>
904
</tr>
905
</tbody>
906
</table></div>
907
</div>
908
<hr>
909
<div class="refsect2" lang="en">
910
<a name="id3098736"></a><h3>
911
<a name="g-value-get-boolean"></a>g_value_get_boolean ()</h3>
912
<a class="indexterm" name="id3098749"></a><pre class="programlisting"><a
913
href="../glib/glib-Basic-Types.html#gboolean"
914
>gboolean</a> g_value_get_boolean (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
915
<p>
916
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
917
</p>
918
<div class="variablelist"><table border="0">
919
<col align="left" valign="top">
920
<tbody>
921
<tr>
922
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
923
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>
924
</td>
925
</tr>
926
<tr>
927
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
928
<td>boolean contents of <em class="parameter"><code>value</code></em>
929
930
931
</td>
932
</tr>
933
</tbody>
934
</table></div>
935
</div>
936
<hr>
937
<div class="refsect2" lang="en">
938
<a name="id3098848"></a><h3>
939
<a name="G-IS-PARAM-SPEC-CHAR:CAPS"></a>G_IS_PARAM_SPEC_CHAR()</h3>
940
<a class="indexterm" name="id3098862"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_CHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_CHAR))
941
</pre>
942
<p>
943
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-CHAR:CAPS"><code class="literal">G_TYPE_PARAM_CHAR</code></a>.
944
</p>
945
<div class="variablelist"><table border="0">
946
<col align="left" valign="top">
947
<tbody><tr>
948
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
949
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
950
951
952
</td>
953
</tr></tbody>
954
</table></div>
955
</div>
956
<hr>
957
<div class="refsect2" lang="en">
958
<a name="id3098925"></a><h3>
959
<a name="G-PARAM-SPEC-CHAR:CAPS"></a>G_PARAM_SPEC_CHAR()</h3>
960
<a class="indexterm" name="id3098938"></a><pre class="programlisting">#define G_PARAM_SPEC_CHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_CHAR, GParamSpecChar))
961
</pre>
962
<p>
963
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecChar"><span class="type">GParamSpecChar</span></a>.
964
</p>
965
<div class="variablelist"><table border="0">
966
<col align="left" valign="top">
967
<tbody><tr>
968
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
969
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
970
971
972
</td>
973
</tr></tbody>
974
</table></div>
975
</div>
976
<hr>
977
<div class="refsect2" lang="en">
978
<a name="id3098997"></a><h3>
979
<a name="G-VALUE-HOLDS-CHAR:CAPS"></a>G_VALUE_HOLDS_CHAR()</h3>
980
<a class="indexterm" name="id3099010"></a><pre class="programlisting">#define G_VALUE_HOLDS_CHAR(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_CHAR))
981
</pre>
982
<p>
983
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-CHAR:CAPS"><code class="literal">G_TYPE_CHAR</code></a>.
984
</p>
985
<div class="variablelist"><table border="0">
986
<col align="left" valign="top">
987
<tbody><tr>
988
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
989
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
990
991
992
</td>
993
</tr></tbody>
994
</table></div>
995
</div>
996
<hr>
997
<div class="refsect2" lang="en">
998
<a name="id3099071"></a><h3>
999
<a name="G-TYPE-PARAM-CHAR:CAPS"></a>G_TYPE_PARAM_CHAR</h3>
1000
<a class="indexterm" name="id3099085"></a><pre class="programlisting">#define G_TYPE_PARAM_CHAR (g_param_spec_types[0])
1001
</pre>
1002
<p>
1003
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecChar"><span class="type">GParamSpecChar</span></a>.
1004
</p>
1005
</div>
1006
<hr>
1007
<div class="refsect2" lang="en">
1008
<a name="id3099117"></a><h3>
1009
<a name="GParamSpecChar"></a>GParamSpecChar</h3>
1010
<a class="indexterm" name="id3099130"></a><pre class="programlisting">typedef struct {
1011
GParamSpec parent_instance;
1012
1013
gint8 minimum;
1014
gint8 maximum;
1015
gint8 default_value;
1016
} GParamSpecChar;
1017
</pre>
1018
<p>
1019
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for character properties.
1020
</p>
1021
<div class="variablelist"><table border="0">
1022
<col align="left" valign="top">
1023
<tbody>
1024
<tr>
1025
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
1026
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
1027
</td>
1028
</tr>
1029
<tr>
1030
<td><span class="term"><a
1031
href="../glib/glib-Basic-Types.html#gint8"
1032
>gint8</a> <em class="structfield"><code>minimum</code></em>;</span></td>
1033
<td> minimum value for the property specified
1034
</td>
1035
</tr>
1036
<tr>
1037
<td><span class="term"><a
1038
href="../glib/glib-Basic-Types.html#gint8"
1039
>gint8</a> <em class="structfield"><code>maximum</code></em>;</span></td>
1040
<td> maximum value for the property specified
1041
</td>
1042
</tr>
1043
<tr>
1044
<td><span class="term"><a
1045
href="../glib/glib-Basic-Types.html#gint8"
1046
>gint8</a> <em class="structfield"><code>default_value</code></em>;</span></td>
1047
<td> default value for the property specified
1048
1049
</td>
1050
</tr>
1051
</tbody>
1052
</table></div>
1053
</div>
1054
<hr>
1055
<div class="refsect2" lang="en">
1056
<a name="id3099252"></a><h3>
1057
<a name="g-param-spec-char"></a>g_param_spec_char ()</h3>
1058
<a class="indexterm" name="id3099265"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_char (const <a
1059
href="../glib/glib-Basic-Types.html#gchar"
1060
>gchar</a> *name,
1061
const <a
1062
href="../glib/glib-Basic-Types.html#gchar"
1063
>gchar</a> *nick,
1064
const <a
1065
href="../glib/glib-Basic-Types.html#gchar"
1066
>gchar</a> *blurb,
1067
<a
1068
href="../glib/glib-Basic-Types.html#gint8"
1069
>gint8</a> minimum,
1070
<a
1071
href="../glib/glib-Basic-Types.html#gint8"
1072
>gint8</a> maximum,
1073
<a
1074
href="../glib/glib-Basic-Types.html#gint8"
1075
>gint8</a> default_value,
1076
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
1077
<p>
1078
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecChar"><span class="type">GParamSpecChar</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-CHAR:CAPS"><code class="literal">G_TYPE_CHAR</code></a> property.
1079
</p>
1080
<div class="variablelist"><table border="0">
1081
<col align="left" valign="top">
1082
<tbody>
1083
<tr>
1084
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
1085
<td> canonical name of the property specified
1086
</td>
1087
</tr>
1088
<tr>
1089
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
1090
<td> nick name for the property specified
1091
</td>
1092
</tr>
1093
<tr>
1094
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
1095
<td> description of the property specified
1096
</td>
1097
</tr>
1098
<tr>
1099
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
1100
<td> minimum value for the property specified
1101
</td>
1102
</tr>
1103
<tr>
1104
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
1105
<td> maximum value for the property specified
1106
</td>
1107
</tr>
1108
<tr>
1109
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
1110
<td>default value for the property specified
1111
</td>
1112
</tr>
1113
<tr>
1114
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
1115
<td> flags for the property specified
1116
</td>
1117
</tr>
1118
<tr>
1119
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1120
<td>a newly created parameter specification
1121
1122
1123
</td>
1124
</tr>
1125
</tbody>
1126
</table></div>
1127
</div>
1128
<hr>
1129
<div class="refsect2" lang="en">
1130
<a name="id3099476"></a><h3>
1131
<a name="g-value-set-char"></a>g_value_set_char ()</h3>
1132
<a class="indexterm" name="id3099489"></a><pre class="programlisting">void g_value_set_char (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
1133
<a
1134
href="../glib/glib-Basic-Types.html#gchar"
1135
>gchar</a> v_char);</pre>
1136
<p>
1137
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-CHAR:CAPS"><code class="literal">G_TYPE_CHAR</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_char</code></em>.
1138
</p>
1139
<div class="variablelist"><table border="0">
1140
<col align="left" valign="top">
1141
<tbody>
1142
<tr>
1143
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1144
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-CHAR:CAPS"><code class="literal">G_TYPE_CHAR</code></a>
1145
</td>
1146
</tr>
1147
<tr>
1148
<td><span class="term"><em class="parameter"><code>v_char</code></em> :</span></td>
1149
<td>character value to be set
1150
1151
1152
</td>
1153
</tr>
1154
</tbody>
1155
</table></div>
1156
</div>
1157
<hr>
1158
<div class="refsect2" lang="en">
1159
<a name="id3099601"></a><h3>
1160
<a name="g-value-get-char"></a>g_value_get_char ()</h3>
1161
<a class="indexterm" name="id3099613"></a><pre class="programlisting"><a
1162
href="../glib/glib-Basic-Types.html#gchar"
1163
>gchar</a> g_value_get_char (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
1164
<p>
1165
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-CHAR:CAPS"><code class="literal">G_TYPE_CHAR</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
1166
</p>
1167
<div class="variablelist"><table border="0">
1168
<col align="left" valign="top">
1169
<tbody>
1170
<tr>
1171
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1172
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-CHAR:CAPS"><code class="literal">G_TYPE_CHAR</code></a>
1173
</td>
1174
</tr>
1175
<tr>
1176
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1177
<td>character contents of <em class="parameter"><code>value</code></em>
1178
1179
1180
</td>
1181
</tr>
1182
</tbody>
1183
</table></div>
1184
</div>
1185
<hr>
1186
<div class="refsect2" lang="en">
1187
<a name="id3099713"></a><h3>
1188
<a name="G-IS-PARAM-SPEC-UCHAR:CAPS"></a>G_IS_PARAM_SPEC_UCHAR()</h3>
1189
<a class="indexterm" name="id3099727"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_UCHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UCHAR))
1190
</pre>
1191
<p>
1192
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UCHAR:CAPS"><code class="literal">G_TYPE_PARAM_UCHAR</code></a>.
1193
</p>
1194
<div class="variablelist"><table border="0">
1195
<col align="left" valign="top">
1196
<tbody><tr>
1197
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1198
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1199
1200
1201
</td>
1202
</tr></tbody>
1203
</table></div>
1204
</div>
1205
<hr>
1206
<div class="refsect2" lang="en">
1207
<a name="id3099789"></a><h3>
1208
<a name="G-PARAM-SPEC-UCHAR:CAPS"></a>G_PARAM_SPEC_UCHAR()</h3>
1209
<a class="indexterm" name="id3099802"></a><pre class="programlisting">#define G_PARAM_SPEC_UCHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UCHAR, GParamSpecUChar))
1210
</pre>
1211
<p>
1212
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUChar"><span class="type">GParamSpecUChar</span></a>.
1213
</p>
1214
<div class="variablelist"><table border="0">
1215
<col align="left" valign="top">
1216
<tbody><tr>
1217
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1218
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1219
1220
1221
</td>
1222
</tr></tbody>
1223
</table></div>
1224
</div>
1225
<hr>
1226
<div class="refsect2" lang="en">
1227
<a name="id3099861"></a><h3>
1228
<a name="G-VALUE-HOLDS-UCHAR:CAPS"></a>G_VALUE_HOLDS_UCHAR()</h3>
1229
<a class="indexterm" name="id3099875"></a><pre class="programlisting">#define G_VALUE_HOLDS_UCHAR(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UCHAR))
1230
</pre>
1231
<p>
1232
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a>.
1233
</p>
1234
<div class="variablelist"><table border="0">
1235
<col align="left" valign="top">
1236
<tbody><tr>
1237
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1238
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
1239
1240
1241
</td>
1242
</tr></tbody>
1243
</table></div>
1244
</div>
1245
<hr>
1246
<div class="refsect2" lang="en">
1247
<a name="id3099936"></a><h3>
1248
<a name="G-TYPE-PARAM-UCHAR:CAPS"></a>G_TYPE_PARAM_UCHAR</h3>
1249
<a class="indexterm" name="id3099950"></a><pre class="programlisting">#define G_TYPE_PARAM_UCHAR (g_param_spec_types[1])
1250
</pre>
1251
<p>
1252
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUChar"><span class="type">GParamSpecUChar</span></a>.
1253
</p>
1254
</div>
1255
<hr>
1256
<div class="refsect2" lang="en">
1257
<a name="id3099982"></a><h3>
1258
<a name="GParamSpecUChar"></a>GParamSpecUChar</h3>
1259
<a class="indexterm" name="id3099995"></a><pre class="programlisting">typedef struct {
1260
GParamSpec parent_instance;
1261
1262
guint8 minimum;
1263
guint8 maximum;
1264
guint8 default_value;
1265
} GParamSpecUChar;
1266
</pre>
1267
<p>
1268
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for unsigned character properties.
1269
</p>
1270
<div class="variablelist"><table border="0">
1271
<col align="left" valign="top">
1272
<tbody>
1273
<tr>
1274
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
1275
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
1276
</td>
1277
</tr>
1278
<tr>
1279
<td><span class="term"><a
1280
href="../glib/glib-Basic-Types.html#guint8"
1281
>guint8</a> <em class="structfield"><code>minimum</code></em>;</span></td>
1282
<td> minimum value for the property specified
1283
</td>
1284
</tr>
1285
<tr>
1286
<td><span class="term"><a
1287
href="../glib/glib-Basic-Types.html#guint8"
1288
>guint8</a> <em class="structfield"><code>maximum</code></em>;</span></td>
1289
<td> maximum value for the property specified
1290
</td>
1291
</tr>
1292
<tr>
1293
<td><span class="term"><a
1294
href="../glib/glib-Basic-Types.html#guint8"
1295
>guint8</a> <em class="structfield"><code>default_value</code></em>;</span></td>
1296
<td> default value for the property specified
1297
1298
</td>
1299
</tr>
1300
</tbody>
1301
</table></div>
1302
</div>
1303
<hr>
1304
<div class="refsect2" lang="en">
1305
<a name="id3100117"></a><h3>
1306
<a name="g-param-spec-uchar"></a>g_param_spec_uchar ()</h3>
1307
<a class="indexterm" name="id3100130"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_uchar (const <a
1308
href="../glib/glib-Basic-Types.html#gchar"
1309
>gchar</a> *name,
1310
const <a
1311
href="../glib/glib-Basic-Types.html#gchar"
1312
>gchar</a> *nick,
1313
const <a
1314
href="../glib/glib-Basic-Types.html#gchar"
1315
>gchar</a> *blurb,
1316
<a
1317
href="../glib/glib-Basic-Types.html#guint8"
1318
>guint8</a> minimum,
1319
<a
1320
href="../glib/glib-Basic-Types.html#guint8"
1321
>guint8</a> maximum,
1322
<a
1323
href="../glib/glib-Basic-Types.html#guint8"
1324
>guint8</a> default_value,
1325
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
1326
<p>
1327
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUChar"><span class="type">GParamSpecUChar</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a> property.
1328
</p>
1329
<div class="variablelist"><table border="0">
1330
<col align="left" valign="top">
1331
<tbody>
1332
<tr>
1333
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
1334
<td> canonical name of the property specified
1335
</td>
1336
</tr>
1337
<tr>
1338
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
1339
<td> nick name for the property specified
1340
</td>
1341
</tr>
1342
<tr>
1343
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
1344
<td> description of the property specified
1345
</td>
1346
</tr>
1347
<tr>
1348
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
1349
<td> minimum value for the property specified
1350
</td>
1351
</tr>
1352
<tr>
1353
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
1354
<td> maximum value for the property specified
1355
</td>
1356
</tr>
1357
<tr>
1358
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
1359
<td>default value for the property specified
1360
</td>
1361
</tr>
1362
<tr>
1363
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
1364
<td> flags for the property specified
1365
</td>
1366
</tr>
1367
<tr>
1368
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1369
<td>a newly created parameter specification
1370
1371
1372
</td>
1373
</tr>
1374
</tbody>
1375
</table></div>
1376
</div>
1377
<hr>
1378
<div class="refsect2" lang="en">
1379
<a name="id3100341"></a><h3>
1380
<a name="g-value-set-uchar"></a>g_value_set_uchar ()</h3>
1381
<a class="indexterm" name="id3100355"></a><pre class="programlisting">void g_value_set_uchar (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
1382
<a
1383
href="../glib/glib-Basic-Types.html#guchar"
1384
>guchar</a> v_uchar);</pre>
1385
<p>
1386
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_uchar</code></em>.
1387
</p>
1388
<div class="variablelist"><table border="0">
1389
<col align="left" valign="top">
1390
<tbody>
1391
<tr>
1392
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1393
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a>
1394
</td>
1395
</tr>
1396
<tr>
1397
<td><span class="term"><em class="parameter"><code>v_uchar</code></em> :</span></td>
1398
<td>unsigned character value to be set
1399
1400
1401
</td>
1402
</tr>
1403
</tbody>
1404
</table></div>
1405
</div>
1406
<hr>
1407
<div class="refsect2" lang="en">
1408
<a name="id3100466"></a><h3>
1409
<a name="g-value-get-uchar"></a>g_value_get_uchar ()</h3>
1410
<a class="indexterm" name="id3100479"></a><pre class="programlisting"><a
1411
href="../glib/glib-Basic-Types.html#guchar"
1412
>guchar</a> g_value_get_uchar (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
1413
<p>
1414
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
1415
</p>
1416
<div class="variablelist"><table border="0">
1417
<col align="left" valign="top">
1418
<tbody>
1419
<tr>
1420
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1421
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a>
1422
</td>
1423
</tr>
1424
<tr>
1425
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1426
<td>unsigned character contents of <em class="parameter"><code>value</code></em>
1427
1428
1429
</td>
1430
</tr>
1431
</tbody>
1432
</table></div>
1433
</div>
1434
<hr>
1435
<div class="refsect2" lang="en">
1436
<a name="id3100579"></a><h3>
1437
<a name="G-IS-PARAM-SPEC-INT:CAPS"></a>G_IS_PARAM_SPEC_INT()</h3>
1438
<a class="indexterm" name="id3100592"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_INT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT))
1439
</pre>
1440
<p>
1441
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-INT:CAPS"><code class="literal">G_TYPE_PARAM_INT</code></a>.
1442
</p>
1443
<div class="variablelist"><table border="0">
1444
<col align="left" valign="top">
1445
<tbody><tr>
1446
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1447
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1448
1449
1450
</td>
1451
</tr></tbody>
1452
</table></div>
1453
</div>
1454
<hr>
1455
<div class="refsect2" lang="en">
1456
<a name="id3100655"></a><h3>
1457
<a name="G-PARAM-SPEC-INT:CAPS"></a>G_PARAM_SPEC_INT()</h3>
1458
<a class="indexterm" name="id3100668"></a><pre class="programlisting">#define G_PARAM_SPEC_INT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT, GParamSpecInt))
1459
</pre>
1460
<p>
1461
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt"><span class="type">GParamSpecInt</span></a>.
1462
</p>
1463
<div class="variablelist"><table border="0">
1464
<col align="left" valign="top">
1465
<tbody><tr>
1466
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1467
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1468
1469
1470
</td>
1471
</tr></tbody>
1472
</table></div>
1473
</div>
1474
<hr>
1475
<div class="refsect2" lang="en">
1476
<a name="id3100727"></a><h3>
1477
<a name="G-VALUE-HOLDS-INT:CAPS"></a>G_VALUE_HOLDS_INT()</h3>
1478
<a class="indexterm" name="id3100740"></a><pre class="programlisting">#define G_VALUE_HOLDS_INT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT))
1479
</pre>
1480
<p>
1481
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a>.
1482
</p>
1483
<div class="variablelist"><table border="0">
1484
<col align="left" valign="top">
1485
<tbody><tr>
1486
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1487
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
1488
1489
1490
</td>
1491
</tr></tbody>
1492
</table></div>
1493
</div>
1494
<hr>
1495
<div class="refsect2" lang="en">
1496
<a name="id3100801"></a><h3>
1497
<a name="G-TYPE-PARAM-INT:CAPS"></a>G_TYPE_PARAM_INT</h3>
1498
<a class="indexterm" name="id3100814"></a><pre class="programlisting">#define G_TYPE_PARAM_INT (g_param_spec_types[3])
1499
</pre>
1500
<p>
1501
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt"><span class="type">GParamSpecInt</span></a>.
1502
</p>
1503
</div>
1504
<hr>
1505
<div class="refsect2" lang="en">
1506
<a name="id3100846"></a><h3>
1507
<a name="GParamSpecInt"></a>GParamSpecInt</h3>
1508
<a class="indexterm" name="id3100859"></a><pre class="programlisting">typedef struct {
1509
GParamSpec parent_instance;
1510
1511
gint minimum;
1512
gint maximum;
1513
gint default_value;
1514
} GParamSpecInt;
1515
</pre>
1516
<p>
1517
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for integer properties.
1518
</p>
1519
<div class="variablelist"><table border="0">
1520
<col align="left" valign="top">
1521
<tbody>
1522
<tr>
1523
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
1524
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
1525
</td>
1526
</tr>
1527
<tr>
1528
<td><span class="term"><a
1529
href="../glib/glib-Basic-Types.html#gint"
1530
>gint</a> <em class="structfield"><code>minimum</code></em>;</span></td>
1531
<td> minimum value for the property specified
1532
</td>
1533
</tr>
1534
<tr>
1535
<td><span class="term"><a
1536
href="../glib/glib-Basic-Types.html#gint"
1537
>gint</a> <em class="structfield"><code>maximum</code></em>;</span></td>
1538
<td> maximum value for the property specified
1539
</td>
1540
</tr>
1541
<tr>
1542
<td><span class="term"><a
1543
href="../glib/glib-Basic-Types.html#gint"
1544
>gint</a> <em class="structfield"><code>default_value</code></em>;</span></td>
1545
<td> default value for the property specified
1546
1547
</td>
1548
</tr>
1549
</tbody>
1550
</table></div>
1551
</div>
1552
<hr>
1553
<div class="refsect2" lang="en">
1554
<a name="id3100981"></a><h3>
1555
<a name="g-param-spec-int"></a>g_param_spec_int ()</h3>
1556
<a class="indexterm" name="id3100994"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_int (const <a
1557
href="../glib/glib-Basic-Types.html#gchar"
1558
>gchar</a> *name,
1559
const <a
1560
href="../glib/glib-Basic-Types.html#gchar"
1561
>gchar</a> *nick,
1562
const <a
1563
href="../glib/glib-Basic-Types.html#gchar"
1564
>gchar</a> *blurb,
1565
<a
1566
href="../glib/glib-Basic-Types.html#gint"
1567
>gint</a> minimum,
1568
<a
1569
href="../glib/glib-Basic-Types.html#gint"
1570
>gint</a> maximum,
1571
<a
1572
href="../glib/glib-Basic-Types.html#gint"
1573
>gint</a> default_value,
1574
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
1575
<p>
1576
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt"><span class="type">GParamSpecInt</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a> property.
1577
</p>
1578
<p>
1579
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
1580
</p>
1581
<div class="variablelist"><table border="0">
1582
<col align="left" valign="top">
1583
<tbody>
1584
<tr>
1585
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
1586
<td> canonical name of the property specified
1587
</td>
1588
</tr>
1589
<tr>
1590
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
1591
<td> nick name for the property specified
1592
</td>
1593
</tr>
1594
<tr>
1595
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
1596
<td> description of the property specified
1597
</td>
1598
</tr>
1599
<tr>
1600
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
1601
<td> minimum value for the property specified
1602
</td>
1603
</tr>
1604
<tr>
1605
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
1606
<td> maximum value for the property specified
1607
</td>
1608
</tr>
1609
<tr>
1610
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
1611
<td>default value for the property specified
1612
</td>
1613
</tr>
1614
<tr>
1615
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
1616
<td> flags for the property specified
1617
</td>
1618
</tr>
1619
<tr>
1620
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1621
<td>a newly created parameter specification
1622
1623
1624
</td>
1625
</tr>
1626
</tbody>
1627
</table></div>
1628
</div>
1629
<hr>
1630
<div class="refsect2" lang="en">
1631
<a name="id3101220"></a><h3>
1632
<a name="g-value-set-int"></a>g_value_set_int ()</h3>
1633
<a class="indexterm" name="id3101233"></a><pre class="programlisting">void g_value_set_int (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
1634
<a
1635
href="../glib/glib-Basic-Types.html#gint"
1636
>gint</a> v_int);</pre>
1637
<p>
1638
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_int</code></em>.
1639
</p>
1640
<div class="variablelist"><table border="0">
1641
<col align="left" valign="top">
1642
<tbody>
1643
<tr>
1644
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1645
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a>
1646
</td>
1647
</tr>
1648
<tr>
1649
<td><span class="term"><em class="parameter"><code>v_int</code></em> :</span></td>
1650
<td>integer value to be set
1651
1652
1653
</td>
1654
</tr>
1655
</tbody>
1656
</table></div>
1657
</div>
1658
<hr>
1659
<div class="refsect2" lang="en">
1660
<a name="id3101345"></a><h3>
1661
<a name="g-value-get-int"></a>g_value_get_int ()</h3>
1662
<a class="indexterm" name="id3101357"></a><pre class="programlisting"><a
1663
href="../glib/glib-Basic-Types.html#gint"
1664
>gint</a> g_value_get_int (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
1665
<p>
1666
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
1667
</p>
1668
<div class="variablelist"><table border="0">
1669
<col align="left" valign="top">
1670
<tbody>
1671
<tr>
1672
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1673
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a>
1674
</td>
1675
</tr>
1676
<tr>
1677
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1678
<td>integer contents of <em class="parameter"><code>value</code></em>
1679
1680
1681
</td>
1682
</tr>
1683
</tbody>
1684
</table></div>
1685
</div>
1686
<hr>
1687
<div class="refsect2" lang="en">
1688
<a name="id3101457"></a><h3>
1689
<a name="G-IS-PARAM-SPEC-UINT:CAPS"></a>G_IS_PARAM_SPEC_UINT()</h3>
1690
<a class="indexterm" name="id3101471"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_UINT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT))
1691
</pre>
1692
<p>
1693
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UINT:CAPS"><code class="literal">G_TYPE_PARAM_UINT</code></a>.
1694
</p>
1695
<div class="variablelist"><table border="0">
1696
<col align="left" valign="top">
1697
<tbody><tr>
1698
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1699
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1700
1701
1702
</td>
1703
</tr></tbody>
1704
</table></div>
1705
</div>
1706
<hr>
1707
<div class="refsect2" lang="en">
1708
<a name="id3101533"></a><h3>
1709
<a name="G-PARAM-SPEC-UINT:CAPS"></a>G_PARAM_SPEC_UINT()</h3>
1710
<a class="indexterm" name="id3101546"></a><pre class="programlisting">#define G_PARAM_SPEC_UINT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT, GParamSpecUInt))
1711
</pre>
1712
<p>
1713
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt"><span class="type">GParamSpecUInt</span></a>.
1714
</p>
1715
<div class="variablelist"><table border="0">
1716
<col align="left" valign="top">
1717
<tbody><tr>
1718
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1719
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1720
1721
1722
</td>
1723
</tr></tbody>
1724
</table></div>
1725
</div>
1726
<hr>
1727
<div class="refsect2" lang="en">
1728
<a name="id3101606"></a><h3>
1729
<a name="G-VALUE-HOLDS-UINT:CAPS"></a>G_VALUE_HOLDS_UINT()</h3>
1730
<a class="indexterm" name="id3101619"></a><pre class="programlisting">#define G_VALUE_HOLDS_UINT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT))
1731
</pre>
1732
<p>
1733
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a>.
1734
</p>
1735
<div class="variablelist"><table border="0">
1736
<col align="left" valign="top">
1737
<tbody><tr>
1738
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1739
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
1740
1741
1742
</td>
1743
</tr></tbody>
1744
</table></div>
1745
</div>
1746
<hr>
1747
<div class="refsect2" lang="en">
1748
<a name="id3101680"></a><h3>
1749
<a name="G-TYPE-PARAM-UINT:CAPS"></a>G_TYPE_PARAM_UINT</h3>
1750
<a class="indexterm" name="id3101694"></a><pre class="programlisting">#define G_TYPE_PARAM_UINT (g_param_spec_types[4])
1751
</pre>
1752
<p>
1753
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt"><span class="type">GParamSpecUInt</span></a>.
1754
</p>
1755
</div>
1756
<hr>
1757
<div class="refsect2" lang="en">
1758
<a name="id3101726"></a><h3>
1759
<a name="GParamSpecUInt"></a>GParamSpecUInt</h3>
1760
<a class="indexterm" name="id3101738"></a><pre class="programlisting">typedef struct {
1761
GParamSpec parent_instance;
1762
1763
guint minimum;
1764
guint maximum;
1765
guint default_value;
1766
} GParamSpecUInt;
1767
</pre>
1768
<p>
1769
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for unsigned integer properties.
1770
</p>
1771
<div class="variablelist"><table border="0">
1772
<col align="left" valign="top">
1773
<tbody>
1774
<tr>
1775
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
1776
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
1777
</td>
1778
</tr>
1779
<tr>
1780
<td><span class="term"><a
1781
href="../glib/glib-Basic-Types.html#guint"
1782
>guint</a> <em class="structfield"><code>minimum</code></em>;</span></td>
1783
<td> minimum value for the property specified
1784
</td>
1785
</tr>
1786
<tr>
1787
<td><span class="term"><a
1788
href="../glib/glib-Basic-Types.html#guint"
1789
>guint</a> <em class="structfield"><code>maximum</code></em>;</span></td>
1790
<td> maximum value for the property specified
1791
</td>
1792
</tr>
1793
<tr>
1794
<td><span class="term"><a
1795
href="../glib/glib-Basic-Types.html#guint"
1796
>guint</a> <em class="structfield"><code>default_value</code></em>;</span></td>
1797
<td> default value for the property specified
1798
1799
</td>
1800
</tr>
1801
</tbody>
1802
</table></div>
1803
</div>
1804
<hr>
1805
<div class="refsect2" lang="en">
1806
<a name="id3101860"></a><h3>
1807
<a name="g-param-spec-uint"></a>g_param_spec_uint ()</h3>
1808
<a class="indexterm" name="id3101874"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_uint (const <a
1809
href="../glib/glib-Basic-Types.html#gchar"
1810
>gchar</a> *name,
1811
const <a
1812
href="../glib/glib-Basic-Types.html#gchar"
1813
>gchar</a> *nick,
1814
const <a
1815
href="../glib/glib-Basic-Types.html#gchar"
1816
>gchar</a> *blurb,
1817
<a
1818
href="../glib/glib-Basic-Types.html#guint"
1819
>guint</a> minimum,
1820
<a
1821
href="../glib/glib-Basic-Types.html#guint"
1822
>guint</a> maximum,
1823
<a
1824
href="../glib/glib-Basic-Types.html#guint"
1825
>guint</a> default_value,
1826
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
1827
<p>
1828
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt"><span class="type">GParamSpecUInt</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a> property.
1829
</p>
1830
<p>
1831
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
1832
</p>
1833
<div class="variablelist"><table border="0">
1834
<col align="left" valign="top">
1835
<tbody>
1836
<tr>
1837
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
1838
<td> canonical name of the property specified
1839
</td>
1840
</tr>
1841
<tr>
1842
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
1843
<td> nick name for the property specified
1844
</td>
1845
</tr>
1846
<tr>
1847
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
1848
<td> description of the property specified
1849
</td>
1850
</tr>
1851
<tr>
1852
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
1853
<td> minimum value for the property specified
1854
</td>
1855
</tr>
1856
<tr>
1857
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
1858
<td> maximum value for the property specified
1859
</td>
1860
</tr>
1861
<tr>
1862
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
1863
<td>default value for the property specified
1864
</td>
1865
</tr>
1866
<tr>
1867
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
1868
<td> flags for the property specified
1869
</td>
1870
</tr>
1871
<tr>
1872
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1873
<td> a newly created parameter specification
1874
1875
1876
</td>
1877
</tr>
1878
</tbody>
1879
</table></div>
1880
</div>
1881
<hr>
1882
<div class="refsect2" lang="en">
1883
<a name="id3102100"></a><h3>
1884
<a name="g-value-set-uint"></a>g_value_set_uint ()</h3>
1885
<a class="indexterm" name="id3102113"></a><pre class="programlisting">void g_value_set_uint (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
1886
<a
1887
href="../glib/glib-Basic-Types.html#guint"
1888
>guint</a> v_uint);</pre>
1889
<p>
1890
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_uint</code></em>.
1891
</p>
1892
<div class="variablelist"><table border="0">
1893
<col align="left" valign="top">
1894
<tbody>
1895
<tr>
1896
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1897
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a>
1898
</td>
1899
</tr>
1900
<tr>
1901
<td><span class="term"><em class="parameter"><code>v_uint</code></em> :</span></td>
1902
<td>unsigned integer value to be set
1903
1904
1905
</td>
1906
</tr>
1907
</tbody>
1908
</table></div>
1909
</div>
1910
<hr>
1911
<div class="refsect2" lang="en">
1912
<a name="id3102224"></a><h3>
1913
<a name="g-value-get-uint"></a>g_value_get_uint ()</h3>
1914
<a class="indexterm" name="id3102237"></a><pre class="programlisting"><a
1915
href="../glib/glib-Basic-Types.html#guint"
1916
>guint</a> g_value_get_uint (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
1917
<p>
1918
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
1919
</p>
1920
<div class="variablelist"><table border="0">
1921
<col align="left" valign="top">
1922
<tbody>
1923
<tr>
1924
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1925
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a>
1926
</td>
1927
</tr>
1928
<tr>
1929
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1930
<td>unsigned integer contents of <em class="parameter"><code>value</code></em>
1931
1932
1933
</td>
1934
</tr>
1935
</tbody>
1936
</table></div>
1937
</div>
1938
<hr>
1939
<div class="refsect2" lang="en">
1940
<a name="id3102337"></a><h3>
1941
<a name="G-IS-PARAM-SPEC-LONG:CAPS"></a>G_IS_PARAM_SPEC_LONG()</h3>
1942
<a class="indexterm" name="id3102350"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_LONG(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_LONG))
1943
</pre>
1944
<p>
1945
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-LONG:CAPS"><code class="literal">G_TYPE_PARAM_LONG</code></a>.
1946
</p>
1947
<div class="variablelist"><table border="0">
1948
<col align="left" valign="top">
1949
<tbody><tr>
1950
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1951
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1952
1953
1954
</td>
1955
</tr></tbody>
1956
</table></div>
1957
</div>
1958
<hr>
1959
<div class="refsect2" lang="en">
1960
<a name="id3102412"></a><h3>
1961
<a name="G-PARAM-SPEC-LONG:CAPS"></a>G_PARAM_SPEC_LONG()</h3>
1962
<a class="indexterm" name="id3102425"></a><pre class="programlisting">#define G_PARAM_SPEC_LONG(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_LONG, GParamSpecLong))
1963
</pre>
1964
<p>
1965
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecLong"><span class="type">GParamSpecLong</span></a>.
1966
</p>
1967
<div class="variablelist"><table border="0">
1968
<col align="left" valign="top">
1969
<tbody><tr>
1970
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
1971
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
1972
1973
1974
</td>
1975
</tr></tbody>
1976
</table></div>
1977
</div>
1978
<hr>
1979
<div class="refsect2" lang="en">
1980
<a name="id3102485"></a><h3>
1981
<a name="G-VALUE-HOLDS-LONG:CAPS"></a>G_VALUE_HOLDS_LONG()</h3>
1982
<a class="indexterm" name="id3102497"></a><pre class="programlisting">#define G_VALUE_HOLDS_LONG(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_LONG))
1983
</pre>
1984
<p>
1985
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-LONG:CAPS"><code class="literal">G_TYPE_LONG</code></a>.
1986
</p>
1987
<div class="variablelist"><table border="0">
1988
<col align="left" valign="top">
1989
<tbody><tr>
1990
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1991
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
1992
1993
1994
</td>
1995
</tr></tbody>
1996
</table></div>
1997
</div>
1998
<hr>
1999
<div class="refsect2" lang="en">
2000
<a name="id3102559"></a><h3>
2001
<a name="G-TYPE-PARAM-LONG:CAPS"></a>G_TYPE_PARAM_LONG</h3>
2002
<a class="indexterm" name="id3102572"></a><pre class="programlisting">#define G_TYPE_PARAM_LONG (g_param_spec_types[5])
2003
</pre>
2004
<p>
2005
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecLong"><span class="type">GParamSpecLong</span></a>.
2006
</p>
2007
</div>
2008
<hr>
2009
<div class="refsect2" lang="en">
2010
<a name="id3102605"></a><h3>
2011
<a name="GParamSpecLong"></a>GParamSpecLong</h3>
2012
<a class="indexterm" name="id3102617"></a><pre class="programlisting">typedef struct {
2013
GParamSpec parent_instance;
2014
2015
glong minimum;
2016
glong maximum;
2017
glong default_value;
2018
} GParamSpecLong;
2019
</pre>
2020
<p>
2021
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for long integer properties.
2022
</p>
2023
<div class="variablelist"><table border="0">
2024
<col align="left" valign="top">
2025
<tbody>
2026
<tr>
2027
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
2028
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
2029
</td>
2030
</tr>
2031
<tr>
2032
<td><span class="term"><a
2033
href="../glib/glib-Basic-Types.html#glong"
2034
>glong</a> <em class="structfield"><code>minimum</code></em>;</span></td>
2035
<td> minimum value for the property specified
2036
</td>
2037
</tr>
2038
<tr>
2039
<td><span class="term"><a
2040
href="../glib/glib-Basic-Types.html#glong"
2041
>glong</a> <em class="structfield"><code>maximum</code></em>;</span></td>
2042
<td> maximum value for the property specified
2043
</td>
2044
</tr>
2045
<tr>
2046
<td><span class="term"><a
2047
href="../glib/glib-Basic-Types.html#glong"
2048
>glong</a> <em class="structfield"><code>default_value</code></em>;</span></td>
2049
<td> default value for the property specified
2050
2051
</td>
2052
</tr>
2053
</tbody>
2054
</table></div>
2055
</div>
2056
<hr>
2057
<div class="refsect2" lang="en">
2058
<a name="id3102739"></a><h3>
2059
<a name="g-param-spec-long"></a>g_param_spec_long ()</h3>
2060
<a class="indexterm" name="id3102753"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_long (const <a
2061
href="../glib/glib-Basic-Types.html#gchar"
2062
>gchar</a> *name,
2063
const <a
2064
href="../glib/glib-Basic-Types.html#gchar"
2065
>gchar</a> *nick,
2066
const <a
2067
href="../glib/glib-Basic-Types.html#gchar"
2068
>gchar</a> *blurb,
2069
<a
2070
href="../glib/glib-Basic-Types.html#glong"
2071
>glong</a> minimum,
2072
<a
2073
href="../glib/glib-Basic-Types.html#glong"
2074
>glong</a> maximum,
2075
<a
2076
href="../glib/glib-Basic-Types.html#glong"
2077
>glong</a> default_value,
2078
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
2079
<p>
2080
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecLong"><span class="type">GParamSpecLong</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-LONG:CAPS"><code class="literal">G_TYPE_LONG</code></a> property.
2081
</p>
2082
<p>
2083
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
2084
</p>
2085
<div class="variablelist"><table border="0">
2086
<col align="left" valign="top">
2087
<tbody>
2088
<tr>
2089
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
2090
<td> canonical name of the property specified
2091
</td>
2092
</tr>
2093
<tr>
2094
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
2095
<td> nick name for the property specified
2096
</td>
2097
</tr>
2098
<tr>
2099
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
2100
<td> description of the property specified
2101
</td>
2102
</tr>
2103
<tr>
2104
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
2105
<td> minimum value for the property specified
2106
</td>
2107
</tr>
2108
<tr>
2109
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
2110
<td> maximum value for the property specified
2111
</td>
2112
</tr>
2113
<tr>
2114
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
2115
<td>default value for the property specified
2116
</td>
2117
</tr>
2118
<tr>
2119
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
2120
<td> flags for the property specified
2121
</td>
2122
</tr>
2123
<tr>
2124
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2125
<td>a newly created parameter specification
2126
2127
2128
</td>
2129
</tr>
2130
</tbody>
2131
</table></div>
2132
</div>
2133
<hr>
2134
<div class="refsect2" lang="en">
2135
<a name="id3102979"></a><h3>
2136
<a name="g-value-set-long"></a>g_value_set_long ()</h3>
2137
<a class="indexterm" name="id3102992"></a><pre class="programlisting">void g_value_set_long (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
2138
<a
2139
href="../glib/glib-Basic-Types.html#glong"
2140
>glong</a> v_long);</pre>
2141
<p>
2142
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-LONG:CAPS"><code class="literal">G_TYPE_LONG</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_long</code></em>.
2143
</p>
2144
<div class="variablelist"><table border="0">
2145
<col align="left" valign="top">
2146
<tbody>
2147
<tr>
2148
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2149
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-LONG:CAPS"><code class="literal">G_TYPE_LONG</code></a>
2150
</td>
2151
</tr>
2152
<tr>
2153
<td><span class="term"><em class="parameter"><code>v_long</code></em> :</span></td>
2154
<td>long integer value to be set
2155
2156
2157
</td>
2158
</tr>
2159
</tbody>
2160
</table></div>
2161
</div>
2162
<hr>
2163
<div class="refsect2" lang="en">
2164
<a name="id3103103"></a><h3>
2165
<a name="g-value-get-long"></a>g_value_get_long ()</h3>
2166
<a class="indexterm" name="id3103116"></a><pre class="programlisting"><a
2167
href="../glib/glib-Basic-Types.html#glong"
2168
>glong</a> g_value_get_long (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
2169
<p>
2170
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-LONG:CAPS"><code class="literal">G_TYPE_LONG</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
2171
</p>
2172
<div class="variablelist"><table border="0">
2173
<col align="left" valign="top">
2174
<tbody>
2175
<tr>
2176
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2177
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-LONG:CAPS"><code class="literal">G_TYPE_LONG</code></a>
2178
</td>
2179
</tr>
2180
<tr>
2181
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2182
<td>long integer contents of <em class="parameter"><code>value</code></em>
2183
2184
2185
</td>
2186
</tr>
2187
</tbody>
2188
</table></div>
2189
</div>
2190
<hr>
2191
<div class="refsect2" lang="en">
2192
<a name="id3103216"></a><h3>
2193
<a name="G-IS-PARAM-SPEC-ULONG:CAPS"></a>G_IS_PARAM_SPEC_ULONG()</h3>
2194
<a class="indexterm" name="id3103229"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_ULONG(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ULONG))
2195
</pre>
2196
<p>
2197
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-ULONG:CAPS"><code class="literal">G_TYPE_PARAM_ULONG</code></a>.
2198
</p>
2199
<div class="variablelist"><table border="0">
2200
<col align="left" valign="top">
2201
<tbody><tr>
2202
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2203
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2204
2205
2206
</td>
2207
</tr></tbody>
2208
</table></div>
2209
</div>
2210
<hr>
2211
<div class="refsect2" lang="en">
2212
<a name="id3103291"></a><h3>
2213
<a name="G-PARAM-SPEC-ULONG:CAPS"></a>G_PARAM_SPEC_ULONG()</h3>
2214
<a class="indexterm" name="id3103304"></a><pre class="programlisting">#define G_PARAM_SPEC_ULONG(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ULONG, GParamSpecULong))
2215
</pre>
2216
<p>
2217
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecULong"><span class="type">GParamSpecULong</span></a>.
2218
</p>
2219
<div class="variablelist"><table border="0">
2220
<col align="left" valign="top">
2221
<tbody><tr>
2222
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2223
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2224
2225
2226
</td>
2227
</tr></tbody>
2228
</table></div>
2229
</div>
2230
<hr>
2231
<div class="refsect2" lang="en">
2232
<a name="id3103363"></a><h3>
2233
<a name="G-VALUE-HOLDS-ULONG:CAPS"></a>G_VALUE_HOLDS_ULONG()</h3>
2234
<a class="indexterm" name="id3103377"></a><pre class="programlisting">#define G_VALUE_HOLDS_ULONG(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ULONG))
2235
</pre>
2236
<p>
2237
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-ULONG:CAPS"><code class="literal">G_TYPE_ULONG</code></a>.
2238
</p>
2239
<div class="variablelist"><table border="0">
2240
<col align="left" valign="top">
2241
<tbody><tr>
2242
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2243
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
2244
2245
2246
</td>
2247
</tr></tbody>
2248
</table></div>
2249
</div>
2250
<hr>
2251
<div class="refsect2" lang="en">
2252
<a name="id3103438"></a><h3>
2253
<a name="G-TYPE-PARAM-ULONG:CAPS"></a>G_TYPE_PARAM_ULONG</h3>
2254
<a class="indexterm" name="id3103452"></a><pre class="programlisting">#define G_TYPE_PARAM_ULONG (g_param_spec_types[6])
2255
</pre>
2256
<p>
2257
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecULong"><span class="type">GParamSpecULong</span></a>.
2258
</p>
2259
</div>
2260
<hr>
2261
<div class="refsect2" lang="en">
2262
<a name="id3103484"></a><h3>
2263
<a name="GParamSpecULong"></a>GParamSpecULong</h3>
2264
<a class="indexterm" name="id3103496"></a><pre class="programlisting">typedef struct {
2265
GParamSpec parent_instance;
2266
2267
gulong minimum;
2268
gulong maximum;
2269
gulong default_value;
2270
} GParamSpecULong;
2271
</pre>
2272
<p>
2273
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for unsigned long integer properties.
2274
</p>
2275
<div class="variablelist"><table border="0">
2276
<col align="left" valign="top">
2277
<tbody>
2278
<tr>
2279
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
2280
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
2281
</td>
2282
</tr>
2283
<tr>
2284
<td><span class="term"><a
2285
href="../glib/glib-Basic-Types.html#gulong"
2286
>gulong</a> <em class="structfield"><code>minimum</code></em>;</span></td>
2287
<td> minimum value for the property specified
2288
</td>
2289
</tr>
2290
<tr>
2291
<td><span class="term"><a
2292
href="../glib/glib-Basic-Types.html#gulong"
2293
>gulong</a> <em class="structfield"><code>maximum</code></em>;</span></td>
2294
<td> maximum value for the property specified
2295
</td>
2296
</tr>
2297
<tr>
2298
<td><span class="term"><a
2299
href="../glib/glib-Basic-Types.html#gulong"
2300
>gulong</a> <em class="structfield"><code>default_value</code></em>;</span></td>
2301
<td> default value for the property specified
2302
2303
</td>
2304
</tr>
2305
</tbody>
2306
</table></div>
2307
</div>
2308
<hr>
2309
<div class="refsect2" lang="en">
2310
<a name="id3103619"></a><h3>
2311
<a name="g-param-spec-ulong"></a>g_param_spec_ulong ()</h3>
2312
<a class="indexterm" name="id3103632"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_ulong (const <a
2313
href="../glib/glib-Basic-Types.html#gchar"
2314
>gchar</a> *name,
2315
const <a
2316
href="../glib/glib-Basic-Types.html#gchar"
2317
>gchar</a> *nick,
2318
const <a
2319
href="../glib/glib-Basic-Types.html#gchar"
2320
>gchar</a> *blurb,
2321
<a
2322
href="../glib/glib-Basic-Types.html#gulong"
2323
>gulong</a> minimum,
2324
<a
2325
href="../glib/glib-Basic-Types.html#gulong"
2326
>gulong</a> maximum,
2327
<a
2328
href="../glib/glib-Basic-Types.html#gulong"
2329
>gulong</a> default_value,
2330
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
2331
<p>
2332
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecULong"><span class="type">GParamSpecULong</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-ULONG:CAPS"><code class="literal">G_TYPE_ULONG</code></a> property.
2333
</p>
2334
<p>
2335
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
2336
</p>
2337
<div class="variablelist"><table border="0">
2338
<col align="left" valign="top">
2339
<tbody>
2340
<tr>
2341
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
2342
<td> canonical name of the property specified
2343
</td>
2344
</tr>
2345
<tr>
2346
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
2347
<td> nick name for the property specified
2348
</td>
2349
</tr>
2350
<tr>
2351
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
2352
<td> description of the property specified
2353
</td>
2354
</tr>
2355
<tr>
2356
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
2357
<td> minimum value for the property specified
2358
</td>
2359
</tr>
2360
<tr>
2361
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
2362
<td> maximum value for the property specified
2363
</td>
2364
</tr>
2365
<tr>
2366
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
2367
<td>default value for the property specified
2368
</td>
2369
</tr>
2370
<tr>
2371
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
2372
<td> flags for the property specified
2373
</td>
2374
</tr>
2375
<tr>
2376
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2377
<td> a newly created parameter specification
2378
2379
2380
</td>
2381
</tr>
2382
</tbody>
2383
</table></div>
2384
</div>
2385
<hr>
2386
<div class="refsect2" lang="en">
2387
<a name="id3103858"></a><h3>
2388
<a name="g-value-set-ulong"></a>g_value_set_ulong ()</h3>
2389
<a class="indexterm" name="id3103871"></a><pre class="programlisting">void g_value_set_ulong (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
2390
<a
2391
href="../glib/glib-Basic-Types.html#gulong"
2392
>gulong</a> v_ulong);</pre>
2393
<p>
2394
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-ULONG:CAPS"><code class="literal">G_TYPE_ULONG</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_ulong</code></em>.
2395
</p>
2396
<div class="variablelist"><table border="0">
2397
<col align="left" valign="top">
2398
<tbody>
2399
<tr>
2400
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2401
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-ULONG:CAPS"><code class="literal">G_TYPE_ULONG</code></a>
2402
</td>
2403
</tr>
2404
<tr>
2405
<td><span class="term"><em class="parameter"><code>v_ulong</code></em> :</span></td>
2406
<td>unsigned long integer value to be set
2407
2408
2409
</td>
2410
</tr>
2411
</tbody>
2412
</table></div>
2413
</div>
2414
<hr>
2415
<div class="refsect2" lang="en">
2416
<a name="id3103982"></a><h3>
2417
<a name="g-value-get-ulong"></a>g_value_get_ulong ()</h3>
2418
<a class="indexterm" name="id3103995"></a><pre class="programlisting"><a
2419
href="../glib/glib-Basic-Types.html#gulong"
2420
>gulong</a> g_value_get_ulong (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
2421
<p>
2422
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-ULONG:CAPS"><code class="literal">G_TYPE_ULONG</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
2423
</p>
2424
<div class="variablelist"><table border="0">
2425
<col align="left" valign="top">
2426
<tbody>
2427
<tr>
2428
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2429
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-ULONG:CAPS"><code class="literal">G_TYPE_ULONG</code></a>
2430
</td>
2431
</tr>
2432
<tr>
2433
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2434
<td>unsigned long integer contents of <em class="parameter"><code>value</code></em>
2435
2436
2437
</td>
2438
</tr>
2439
</tbody>
2440
</table></div>
2441
</div>
2442
<hr>
2443
<div class="refsect2" lang="en">
2444
<a name="id3104095"></a><h3>
2445
<a name="G-IS-PARAM-SPEC-INT64:CAPS"></a>G_IS_PARAM_SPEC_INT64()</h3>
2446
<a class="indexterm" name="id3104108"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_INT64(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT64))
2447
</pre>
2448
<p>
2449
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-INT64:CAPS"><code class="literal">G_TYPE_PARAM_INT64</code></a>.
2450
</p>
2451
<div class="variablelist"><table border="0">
2452
<col align="left" valign="top">
2453
<tbody><tr>
2454
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2455
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2456
2457
2458
</td>
2459
</tr></tbody>
2460
</table></div>
2461
</div>
2462
<hr>
2463
<div class="refsect2" lang="en">
2464
<a name="id3104171"></a><h3>
2465
<a name="G-PARAM-SPEC-INT64:CAPS"></a>G_PARAM_SPEC_INT64()</h3>
2466
<a class="indexterm" name="id3104184"></a><pre class="programlisting">#define G_PARAM_SPEC_INT64(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT64, GParamSpecInt64))
2467
</pre>
2468
<p>
2469
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt64"><span class="type">GParamSpecInt64</span></a>.
2470
</p>
2471
<div class="variablelist"><table border="0">
2472
<col align="left" valign="top">
2473
<tbody><tr>
2474
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2475
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2476
2477
2478
</td>
2479
</tr></tbody>
2480
</table></div>
2481
</div>
2482
<hr>
2483
<div class="refsect2" lang="en">
2484
<a name="id3104244"></a><h3>
2485
<a name="G-VALUE-HOLDS-INT64:CAPS"></a>G_VALUE_HOLDS_INT64()</h3>
2486
<a class="indexterm" name="id3104257"></a><pre class="programlisting">#define G_VALUE_HOLDS_INT64(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT64))
2487
</pre>
2488
<p>
2489
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-INT64:CAPS"><code class="literal">G_TYPE_INT64</code></a>.
2490
</p>
2491
<div class="variablelist"><table border="0">
2492
<col align="left" valign="top">
2493
<tbody><tr>
2494
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2495
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
2496
2497
2498
</td>
2499
</tr></tbody>
2500
</table></div>
2501
</div>
2502
<hr>
2503
<div class="refsect2" lang="en">
2504
<a name="id3104319"></a><h3>
2505
<a name="G-TYPE-PARAM-INT64:CAPS"></a>G_TYPE_PARAM_INT64</h3>
2506
<a class="indexterm" name="id3104332"></a><pre class="programlisting">#define G_TYPE_PARAM_INT64 (g_param_spec_types[7])
2507
</pre>
2508
<p>
2509
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt64"><span class="type">GParamSpecInt64</span></a>.
2510
</p>
2511
</div>
2512
<hr>
2513
<div class="refsect2" lang="en">
2514
<a name="id3104364"></a><h3>
2515
<a name="GParamSpecInt64"></a>GParamSpecInt64</h3>
2516
<a class="indexterm" name="id3104377"></a><pre class="programlisting">typedef struct {
2517
GParamSpec parent_instance;
2518
2519
gint64 minimum;
2520
gint64 maximum;
2521
gint64 default_value;
2522
} GParamSpecInt64;
2523
</pre>
2524
<p>
2525
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for 64bit integer properties.
2526
</p>
2527
<div class="variablelist"><table border="0">
2528
<col align="left" valign="top">
2529
<tbody>
2530
<tr>
2531
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
2532
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
2533
</td>
2534
</tr>
2535
<tr>
2536
<td><span class="term"><a
2537
href="../glib/glib-Basic-Types.html#gint64"
2538
>gint64</a> <em class="structfield"><code>minimum</code></em>;</span></td>
2539
<td> minimum value for the property specified
2540
</td>
2541
</tr>
2542
<tr>
2543
<td><span class="term"><a
2544
href="../glib/glib-Basic-Types.html#gint64"
2545
>gint64</a> <em class="structfield"><code>maximum</code></em>;</span></td>
2546
<td> maximum value for the property specified
2547
</td>
2548
</tr>
2549
<tr>
2550
<td><span class="term"><a
2551
href="../glib/glib-Basic-Types.html#gint64"
2552
>gint64</a> <em class="structfield"><code>default_value</code></em>;</span></td>
2553
<td> default value for the property specified
2554
2555
</td>
2556
</tr>
2557
</tbody>
2558
</table></div>
2559
</div>
2560
<hr>
2561
<div class="refsect2" lang="en">
2562
<a name="id3104499"></a><h3>
2563
<a name="g-param-spec-int64"></a>g_param_spec_int64 ()</h3>
2564
<a class="indexterm" name="id3104513"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_int64 (const <a
2565
href="../glib/glib-Basic-Types.html#gchar"
2566
>gchar</a> *name,
2567
const <a
2568
href="../glib/glib-Basic-Types.html#gchar"
2569
>gchar</a> *nick,
2570
const <a
2571
href="../glib/glib-Basic-Types.html#gchar"
2572
>gchar</a> *blurb,
2573
<a
2574
href="../glib/glib-Basic-Types.html#gint64"
2575
>gint64</a> minimum,
2576
<a
2577
href="../glib/glib-Basic-Types.html#gint64"
2578
>gint64</a> maximum,
2579
<a
2580
href="../glib/glib-Basic-Types.html#gint64"
2581
>gint64</a> default_value,
2582
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
2583
<p>
2584
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecInt64"><span class="type">GParamSpecInt64</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-INT64:CAPS"><code class="literal">G_TYPE_INT64</code></a> property.
2585
</p>
2586
<p>
2587
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
2588
</p>
2589
<div class="variablelist"><table border="0">
2590
<col align="left" valign="top">
2591
<tbody>
2592
<tr>
2593
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
2594
<td> canonical name of the property specified
2595
</td>
2596
</tr>
2597
<tr>
2598
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
2599
<td> nick name for the property specified
2600
</td>
2601
</tr>
2602
<tr>
2603
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
2604
<td> description of the property specified
2605
</td>
2606
</tr>
2607
<tr>
2608
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
2609
<td> minimum value for the property specified
2610
</td>
2611
</tr>
2612
<tr>
2613
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
2614
<td> maximum value for the property specified
2615
</td>
2616
</tr>
2617
<tr>
2618
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
2619
<td>default value for the property specified
2620
</td>
2621
</tr>
2622
<tr>
2623
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
2624
<td> flags for the property specified
2625
</td>
2626
</tr>
2627
<tr>
2628
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2629
<td>a newly created parameter specification
2630
2631
2632
</td>
2633
</tr>
2634
</tbody>
2635
</table></div>
2636
</div>
2637
<hr>
2638
<div class="refsect2" lang="en">
2639
<a name="id3104739"></a><h3>
2640
<a name="g-value-set-int64"></a>g_value_set_int64 ()</h3>
2641
<a class="indexterm" name="id3104752"></a><pre class="programlisting">void g_value_set_int64 (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
2642
<a
2643
href="../glib/glib-Basic-Types.html#gint64"
2644
>gint64</a> v_int64);</pre>
2645
<p>
2646
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-INT64:CAPS"><code class="literal">G_TYPE_INT64</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_int64</code></em>.
2647
</p>
2648
<div class="variablelist"><table border="0">
2649
<col align="left" valign="top">
2650
<tbody>
2651
<tr>
2652
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2653
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-INT64:CAPS"><code class="literal">G_TYPE_INT64</code></a>
2654
</td>
2655
</tr>
2656
<tr>
2657
<td><span class="term"><em class="parameter"><code>v_int64</code></em> :</span></td>
2658
<td>64bit integer value to be set
2659
2660
2661
</td>
2662
</tr>
2663
</tbody>
2664
</table></div>
2665
</div>
2666
<hr>
2667
<div class="refsect2" lang="en">
2668
<a name="id3104863"></a><h3>
2669
<a name="g-value-get-int64"></a>g_value_get_int64 ()</h3>
2670
<a class="indexterm" name="id3104876"></a><pre class="programlisting"><a
2671
href="../glib/glib-Basic-Types.html#gint64"
2672
>gint64</a> g_value_get_int64 (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
2673
<p>
2674
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-INT64:CAPS"><code class="literal">G_TYPE_INT64</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
2675
</p>
2676
<div class="variablelist"><table border="0">
2677
<col align="left" valign="top">
2678
<tbody>
2679
<tr>
2680
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2681
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-INT64:CAPS"><code class="literal">G_TYPE_INT64</code></a>
2682
</td>
2683
</tr>
2684
<tr>
2685
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2686
<td>64bit integer contents of <em class="parameter"><code>value</code></em>
2687
2688
2689
</td>
2690
</tr>
2691
</tbody>
2692
</table></div>
2693
</div>
2694
<hr>
2695
<div class="refsect2" lang="en">
2696
<a name="id3104976"></a><h3>
2697
<a name="G-IS-PARAM-SPEC-UINT64:CAPS"></a>G_IS_PARAM_SPEC_UINT64()</h3>
2698
<a class="indexterm" name="id3104989"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_UINT64(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT64))
2699
</pre>
2700
<p>
2701
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UINT64:CAPS"><code class="literal">G_TYPE_PARAM_UINT64</code></a>.
2702
</p>
2703
<div class="variablelist"><table border="0">
2704
<col align="left" valign="top">
2705
<tbody><tr>
2706
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2707
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2708
2709
2710
</td>
2711
</tr></tbody>
2712
</table></div>
2713
</div>
2714
<hr>
2715
<div class="refsect2" lang="en">
2716
<a name="id3105052"></a><h3>
2717
<a name="G-PARAM-SPEC-UINT64:CAPS"></a>G_PARAM_SPEC_UINT64()</h3>
2718
<a class="indexterm" name="id3105064"></a><pre class="programlisting">#define G_PARAM_SPEC_UINT64(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT64, GParamSpecUInt64))
2719
</pre>
2720
<p>
2721
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt64"><span class="type">GParamSpecUInt64</span></a>.
2722
</p>
2723
<div class="variablelist"><table border="0">
2724
<col align="left" valign="top">
2725
<tbody><tr>
2726
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2727
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2728
2729
2730
</td>
2731
</tr></tbody>
2732
</table></div>
2733
</div>
2734
<hr>
2735
<div class="refsect2" lang="en">
2736
<a name="id3105124"></a><h3>
2737
<a name="G-VALUE-HOLDS-UINT64:CAPS"></a>G_VALUE_HOLDS_UINT64()</h3>
2738
<a class="indexterm" name="id3105137"></a><pre class="programlisting">#define G_VALUE_HOLDS_UINT64(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT64))
2739
</pre>
2740
<p>
2741
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><code class="literal">G_TYPE_UINT64</code></a>.
2742
</p>
2743
<div class="variablelist"><table border="0">
2744
<col align="left" valign="top">
2745
<tbody><tr>
2746
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2747
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
2748
2749
2750
</td>
2751
</tr></tbody>
2752
</table></div>
2753
</div>
2754
<hr>
2755
<div class="refsect2" lang="en">
2756
<a name="id3105199"></a><h3>
2757
<a name="G-TYPE-PARAM-UINT64:CAPS"></a>G_TYPE_PARAM_UINT64</h3>
2758
<a class="indexterm" name="id3105213"></a><pre class="programlisting">#define G_TYPE_PARAM_UINT64 (g_param_spec_types[8])
2759
</pre>
2760
<p>
2761
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt64"><span class="type">GParamSpecUInt64</span></a>.
2762
</p>
2763
</div>
2764
<hr>
2765
<div class="refsect2" lang="en">
2766
<a name="id3105245"></a><h3>
2767
<a name="GParamSpecUInt64"></a>GParamSpecUInt64</h3>
2768
<a class="indexterm" name="id3105257"></a><pre class="programlisting">typedef struct {
2769
GParamSpec parent_instance;
2770
2771
guint64 minimum;
2772
guint64 maximum;
2773
guint64 default_value;
2774
} GParamSpecUInt64;
2775
</pre>
2776
<p>
2777
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for unsigned 64bit integer properties.
2778
</p>
2779
<div class="variablelist"><table border="0">
2780
<col align="left" valign="top">
2781
<tbody>
2782
<tr>
2783
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
2784
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
2785
</td>
2786
</tr>
2787
<tr>
2788
<td><span class="term"><a
2789
href="../glib/glib-Basic-Types.html#guint64"
2790
>guint64</a> <em class="structfield"><code>minimum</code></em>;</span></td>
2791
<td> minimum value for the property specified
2792
</td>
2793
</tr>
2794
<tr>
2795
<td><span class="term"><a
2796
href="../glib/glib-Basic-Types.html#guint64"
2797
>guint64</a> <em class="structfield"><code>maximum</code></em>;</span></td>
2798
<td> maximum value for the property specified
2799
</td>
2800
</tr>
2801
<tr>
2802
<td><span class="term"><a
2803
href="../glib/glib-Basic-Types.html#guint64"
2804
>guint64</a> <em class="structfield"><code>default_value</code></em>;</span></td>
2805
<td> default value for the property specified
2806
2807
</td>
2808
</tr>
2809
</tbody>
2810
</table></div>
2811
</div>
2812
<hr>
2813
<div class="refsect2" lang="en">
2814
<a name="id3105380"></a><h3>
2815
<a name="g-param-spec-uint64"></a>g_param_spec_uint64 ()</h3>
2816
<a class="indexterm" name="id3105393"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_uint64 (const <a
2817
href="../glib/glib-Basic-Types.html#gchar"
2818
>gchar</a> *name,
2819
const <a
2820
href="../glib/glib-Basic-Types.html#gchar"
2821
>gchar</a> *nick,
2822
const <a
2823
href="../glib/glib-Basic-Types.html#gchar"
2824
>gchar</a> *blurb,
2825
<a
2826
href="../glib/glib-Basic-Types.html#guint64"
2827
>guint64</a> minimum,
2828
<a
2829
href="../glib/glib-Basic-Types.html#guint64"
2830
>guint64</a> maximum,
2831
<a
2832
href="../glib/glib-Basic-Types.html#guint64"
2833
>guint64</a> default_value,
2834
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
2835
<p>
2836
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUInt64"><span class="type">GParamSpecUInt64</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><code class="literal">G_TYPE_UINT64</code></a>
2837
property.
2838
</p>
2839
<p>
2840
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
2841
</p>
2842
<div class="variablelist"><table border="0">
2843
<col align="left" valign="top">
2844
<tbody>
2845
<tr>
2846
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
2847
<td> canonical name of the property specified
2848
</td>
2849
</tr>
2850
<tr>
2851
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
2852
<td> nick name for the property specified
2853
</td>
2854
</tr>
2855
<tr>
2856
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
2857
<td> description of the property specified
2858
</td>
2859
</tr>
2860
<tr>
2861
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
2862
<td> minimum value for the property specified
2863
</td>
2864
</tr>
2865
<tr>
2866
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
2867
<td> maximum value for the property specified
2868
</td>
2869
</tr>
2870
<tr>
2871
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
2872
<td>default value for the property specified
2873
</td>
2874
</tr>
2875
<tr>
2876
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
2877
<td> flags for the property specified
2878
</td>
2879
</tr>
2880
<tr>
2881
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2882
<td>a newly created parameter specification
2883
2884
2885
</td>
2886
</tr>
2887
</tbody>
2888
</table></div>
2889
</div>
2890
<hr>
2891
<div class="refsect2" lang="en">
2892
<a name="id3105619"></a><h3>
2893
<a name="g-value-set-uint64"></a>g_value_set_uint64 ()</h3>
2894
<a class="indexterm" name="id3105633"></a><pre class="programlisting">void g_value_set_uint64 (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
2895
<a
2896
href="../glib/glib-Basic-Types.html#guint64"
2897
>guint64</a> v_uint64);</pre>
2898
<p>
2899
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><code class="literal">G_TYPE_UINT64</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_uint64</code></em>.
2900
</p>
2901
<div class="variablelist"><table border="0">
2902
<col align="left" valign="top">
2903
<tbody>
2904
<tr>
2905
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2906
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><code class="literal">G_TYPE_UINT64</code></a>
2907
</td>
2908
</tr>
2909
<tr>
2910
<td><span class="term"><em class="parameter"><code>v_uint64</code></em> :</span></td>
2911
<td>unsigned 64bit integer value to be set
2912
2913
2914
</td>
2915
</tr>
2916
</tbody>
2917
</table></div>
2918
</div>
2919
<hr>
2920
<div class="refsect2" lang="en">
2921
<a name="id3105744"></a><h3>
2922
<a name="g-value-get-uint64"></a>g_value_get_uint64 ()</h3>
2923
<a class="indexterm" name="id3105757"></a><pre class="programlisting"><a
2924
href="../glib/glib-Basic-Types.html#guint64"
2925
>guint64</a> g_value_get_uint64 (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
2926
<p>
2927
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><code class="literal">G_TYPE_UINT64</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
2928
</p>
2929
<div class="variablelist"><table border="0">
2930
<col align="left" valign="top">
2931
<tbody>
2932
<tr>
2933
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
2934
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><code class="literal">G_TYPE_UINT64</code></a>
2935
</td>
2936
</tr>
2937
<tr>
2938
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2939
<td>unsigned 64bit integer contents of <em class="parameter"><code>value</code></em>
2940
2941
2942
</td>
2943
</tr>
2944
</tbody>
2945
</table></div>
2946
</div>
2947
<hr>
2948
<div class="refsect2" lang="en">
2949
<a name="id3105857"></a><h3>
2950
<a name="G-IS-PARAM-SPEC-FLOAT:CAPS"></a>G_IS_PARAM_SPEC_FLOAT()</h3>
2951
<a class="indexterm" name="id3105870"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_FLOAT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLOAT))
2952
</pre>
2953
<p>
2954
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-FLOAT:CAPS"><code class="literal">G_TYPE_PARAM_FLOAT</code></a>.
2955
</p>
2956
<div class="variablelist"><table border="0">
2957
<col align="left" valign="top">
2958
<tbody><tr>
2959
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2960
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2961
2962
2963
</td>
2964
</tr></tbody>
2965
</table></div>
2966
</div>
2967
<hr>
2968
<div class="refsect2" lang="en">
2969
<a name="id3105933"></a><h3>
2970
<a name="G-PARAM-SPEC-FLOAT:CAPS"></a>G_PARAM_SPEC_FLOAT()</h3>
2971
<a class="indexterm" name="id3105945"></a><pre class="programlisting">#define G_PARAM_SPEC_FLOAT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLOAT, GParamSpecFloat))
2972
</pre>
2973
<p>
2974
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecFloat"><span class="type">GParamSpecFloat</span></a>.
2975
</p>
2976
<div class="variablelist"><table border="0">
2977
<col align="left" valign="top">
2978
<tbody><tr>
2979
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
2980
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
2981
2982
2983
</td>
2984
</tr></tbody>
2985
</table></div>
2986
</div>
2987
<hr>
2988
<div class="refsect2" lang="en">
2989
<a name="id3106004"></a><h3>
2990
<a name="G-VALUE-HOLDS-FLOAT:CAPS"></a>G_VALUE_HOLDS_FLOAT()</h3>
2991
<a class="indexterm" name="id3106017"></a><pre class="programlisting">#define G_VALUE_HOLDS_FLOAT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLOAT))
2992
</pre>
2993
<p>
2994
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-FLOAT:CAPS"><code class="literal">G_TYPE_FLOAT</code></a>.
2995
</p>
2996
<div class="variablelist"><table border="0">
2997
<col align="left" valign="top">
2998
<tbody><tr>
2999
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3000
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
3001
3002
3003
</td>
3004
</tr></tbody>
3005
</table></div>
3006
</div>
3007
<hr>
3008
<div class="refsect2" lang="en">
3009
<a name="id3106079"></a><h3>
3010
<a name="G-TYPE-PARAM-FLOAT:CAPS"></a>G_TYPE_PARAM_FLOAT</h3>
3011
<a class="indexterm" name="id3106093"></a><pre class="programlisting">#define G_TYPE_PARAM_FLOAT (g_param_spec_types[12])
3012
</pre>
3013
<p>
3014
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecFloat"><span class="type">GParamSpecFloat</span></a>.
3015
</p>
3016
</div>
3017
<hr>
3018
<div class="refsect2" lang="en">
3019
<a name="id3106125"></a><h3>
3020
<a name="GParamSpecFloat"></a>GParamSpecFloat</h3>
3021
<a class="indexterm" name="id3106137"></a><pre class="programlisting">typedef struct {
3022
GParamSpec parent_instance;
3023
3024
gfloat minimum;
3025
gfloat maximum;
3026
gfloat default_value;
3027
gfloat epsilon;
3028
} GParamSpecFloat;
3029
</pre>
3030
<p>
3031
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for float properties.
3032
</p>
3033
<div class="variablelist"><table border="0">
3034
<col align="left" valign="top">
3035
<tbody>
3036
<tr>
3037
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
3038
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
3039
</td>
3040
</tr>
3041
<tr>
3042
<td><span class="term"><a
3043
href="../glib/glib-Basic-Types.html#gfloat"
3044
>gfloat</a> <em class="structfield"><code>minimum</code></em>;</span></td>
3045
<td> minimum value for the property specified
3046
</td>
3047
</tr>
3048
<tr>
3049
<td><span class="term"><a
3050
href="../glib/glib-Basic-Types.html#gfloat"
3051
>gfloat</a> <em class="structfield"><code>maximum</code></em>;</span></td>
3052
<td> maximum value for the property specified
3053
</td>
3054
</tr>
3055
<tr>
3056
<td><span class="term"><a
3057
href="../glib/glib-Basic-Types.html#gfloat"
3058
>gfloat</a> <em class="structfield"><code>default_value</code></em>;</span></td>
3059
<td> default value for the property specified
3060
</td>
3061
</tr>
3062
<tr>
3063
<td><span class="term"><a
3064
href="../glib/glib-Basic-Types.html#gfloat"
3065
>gfloat</a> <em class="structfield"><code>epsilon</code></em>;</span></td>
3066
<td> values closer than <em class="parameter"><code>epsilon</code></em> will be considered identical
3067
by <a href="gobject-GParamSpec.html#g-param-values-cmp"><code class="function">g_param_values_cmp()</code></a>; the default value is 1e-30.
3068
3069
</td>
3070
</tr>
3071
</tbody>
3072
</table></div>
3073
</div>
3074
<hr>
3075
<div class="refsect2" lang="en">
3076
<a name="id3106299"></a><h3>
3077
<a name="g-param-spec-float"></a>g_param_spec_float ()</h3>
3078
<a class="indexterm" name="id3106312"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_float (const <a
3079
href="../glib/glib-Basic-Types.html#gchar"
3080
>gchar</a> *name,
3081
const <a
3082
href="../glib/glib-Basic-Types.html#gchar"
3083
>gchar</a> *nick,
3084
const <a
3085
href="../glib/glib-Basic-Types.html#gchar"
3086
>gchar</a> *blurb,
3087
<a
3088
href="../glib/glib-Basic-Types.html#gfloat"
3089
>gfloat</a> minimum,
3090
<a
3091
href="../glib/glib-Basic-Types.html#gfloat"
3092
>gfloat</a> maximum,
3093
<a
3094
href="../glib/glib-Basic-Types.html#gfloat"
3095
>gfloat</a> default_value,
3096
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
3097
<p>
3098
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecFloat"><span class="type">GParamSpecFloat</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-FLOAT:CAPS"><code class="literal">G_TYPE_FLOAT</code></a> property.
3099
</p>
3100
<p>
3101
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
3102
</p>
3103
<div class="variablelist"><table border="0">
3104
<col align="left" valign="top">
3105
<tbody>
3106
<tr>
3107
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
3108
<td> canonical name of the property specified
3109
</td>
3110
</tr>
3111
<tr>
3112
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
3113
<td> nick name for the property specified
3114
</td>
3115
</tr>
3116
<tr>
3117
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
3118
<td> description of the property specified
3119
</td>
3120
</tr>
3121
<tr>
3122
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
3123
<td> minimum value for the property specified
3124
</td>
3125
</tr>
3126
<tr>
3127
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
3128
<td> maximum value for the property specified
3129
</td>
3130
</tr>
3131
<tr>
3132
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
3133
<td>default value for the property specified
3134
</td>
3135
</tr>
3136
<tr>
3137
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
3138
<td> flags for the property specified
3139
</td>
3140
</tr>
3141
<tr>
3142
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3143
<td>a newly created parameter specification
3144
3145
3146
</td>
3147
</tr>
3148
</tbody>
3149
</table></div>
3150
</div>
3151
<hr>
3152
<div class="refsect2" lang="en">
3153
<a name="id3106539"></a><h3>
3154
<a name="g-value-set-float"></a>g_value_set_float ()</h3>
3155
<a class="indexterm" name="id3106552"></a><pre class="programlisting">void g_value_set_float (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
3156
<a
3157
href="../glib/glib-Basic-Types.html#gfloat"
3158
>gfloat</a> v_float);</pre>
3159
<p>
3160
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-FLOAT:CAPS"><code class="literal">G_TYPE_FLOAT</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_float</code></em>.
3161
</p>
3162
<div class="variablelist"><table border="0">
3163
<col align="left" valign="top">
3164
<tbody>
3165
<tr>
3166
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3167
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-FLOAT:CAPS"><code class="literal">G_TYPE_FLOAT</code></a>
3168
</td>
3169
</tr>
3170
<tr>
3171
<td><span class="term"><em class="parameter"><code>v_float</code></em> :</span></td>
3172
<td>float value to be set
3173
3174
3175
</td>
3176
</tr>
3177
</tbody>
3178
</table></div>
3179
</div>
3180
<hr>
3181
<div class="refsect2" lang="en">
3182
<a name="id3106663"></a><h3>
3183
<a name="g-value-get-float"></a>g_value_get_float ()</h3>
3184
<a class="indexterm" name="id3106676"></a><pre class="programlisting"><a
3185
href="../glib/glib-Basic-Types.html#gfloat"
3186
>gfloat</a> g_value_get_float (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
3187
<p>
3188
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-FLOAT:CAPS"><code class="literal">G_TYPE_FLOAT</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
3189
</p>
3190
<div class="variablelist"><table border="0">
3191
<col align="left" valign="top">
3192
<tbody>
3193
<tr>
3194
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3195
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-FLOAT:CAPS"><code class="literal">G_TYPE_FLOAT</code></a>
3196
</td>
3197
</tr>
3198
<tr>
3199
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3200
<td>float contents of <em class="parameter"><code>value</code></em>
3201
3202
3203
</td>
3204
</tr>
3205
</tbody>
3206
</table></div>
3207
</div>
3208
<hr>
3209
<div class="refsect2" lang="en">
3210
<a name="id3106775"></a><h3>
3211
<a name="G-IS-PARAM-SPEC-DOUBLE:CAPS"></a>G_IS_PARAM_SPEC_DOUBLE()</h3>
3212
<a class="indexterm" name="id3106788"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_DOUBLE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_DOUBLE))
3213
</pre>
3214
<p>
3215
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-DOUBLE:CAPS"><code class="literal">G_TYPE_PARAM_DOUBLE</code></a>.
3216
</p>
3217
<div class="variablelist"><table border="0">
3218
<col align="left" valign="top">
3219
<tbody><tr>
3220
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3221
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3222
3223
3224
</td>
3225
</tr></tbody>
3226
</table></div>
3227
</div>
3228
<hr>
3229
<div class="refsect2" lang="en">
3230
<a name="id3106851"></a><h3>
3231
<a name="G-PARAM-SPEC-DOUBLE:CAPS"></a>G_PARAM_SPEC_DOUBLE()</h3>
3232
<a class="indexterm" name="id3106864"></a><pre class="programlisting">#define G_PARAM_SPEC_DOUBLE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_DOUBLE, GParamSpecDouble))
3233
</pre>
3234
<p>
3235
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecDouble"><span class="type">GParamSpecDouble</span></a>.
3236
</p>
3237
<div class="variablelist"><table border="0">
3238
<col align="left" valign="top">
3239
<tbody><tr>
3240
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3241
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3242
3243
3244
</td>
3245
</tr></tbody>
3246
</table></div>
3247
</div>
3248
<hr>
3249
<div class="refsect2" lang="en">
3250
<a name="id3106923"></a><h3>
3251
<a name="G-VALUE-HOLDS-DOUBLE:CAPS"></a>G_VALUE_HOLDS_DOUBLE()</h3>
3252
<a class="indexterm" name="id3106937"></a><pre class="programlisting">#define G_VALUE_HOLDS_DOUBLE(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_DOUBLE))
3253
</pre>
3254
<p>
3255
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><code class="literal">G_TYPE_DOUBLE</code></a>.
3256
</p>
3257
<div class="variablelist"><table border="0">
3258
<col align="left" valign="top">
3259
<tbody><tr>
3260
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3261
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
3262
3263
3264
</td>
3265
</tr></tbody>
3266
</table></div>
3267
</div>
3268
<hr>
3269
<div class="refsect2" lang="en">
3270
<a name="id3106999"></a><h3>
3271
<a name="G-TYPE-PARAM-DOUBLE:CAPS"></a>G_TYPE_PARAM_DOUBLE</h3>
3272
<a class="indexterm" name="id3107012"></a><pre class="programlisting">#define G_TYPE_PARAM_DOUBLE (g_param_spec_types[13])
3273
</pre>
3274
<p>
3275
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecDouble"><span class="type">GParamSpecDouble</span></a>.
3276
</p>
3277
</div>
3278
<hr>
3279
<div class="refsect2" lang="en">
3280
<a name="id3107044"></a><h3>
3281
<a name="GParamSpecDouble"></a>GParamSpecDouble</h3>
3282
<a class="indexterm" name="id3107057"></a><pre class="programlisting">typedef struct {
3283
GParamSpec parent_instance;
3284
3285
gdouble minimum;
3286
gdouble maximum;
3287
gdouble default_value;
3288
gdouble epsilon;
3289
} GParamSpecDouble;
3290
</pre>
3291
<p>
3292
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for double properties.
3293
</p>
3294
<div class="variablelist"><table border="0">
3295
<col align="left" valign="top">
3296
<tbody>
3297
<tr>
3298
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
3299
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
3300
</td>
3301
</tr>
3302
<tr>
3303
<td><span class="term"><a
3304
href="../glib/glib-Basic-Types.html#gdouble"
3305
>gdouble</a> <em class="structfield"><code>minimum</code></em>;</span></td>
3306
<td> minimum value for the property specified
3307
</td>
3308
</tr>
3309
<tr>
3310
<td><span class="term"><a
3311
href="../glib/glib-Basic-Types.html#gdouble"
3312
>gdouble</a> <em class="structfield"><code>maximum</code></em>;</span></td>
3313
<td> maximum value for the property specified
3314
</td>
3315
</tr>
3316
<tr>
3317
<td><span class="term"><a
3318
href="../glib/glib-Basic-Types.html#gdouble"
3319
>gdouble</a> <em class="structfield"><code>default_value</code></em>;</span></td>
3320
<td> default value for the property specified
3321
</td>
3322
</tr>
3323
<tr>
3324
<td><span class="term"><a
3325
href="../glib/glib-Basic-Types.html#gdouble"
3326
>gdouble</a> <em class="structfield"><code>epsilon</code></em>;</span></td>
3327
<td> values closer than <em class="parameter"><code>epsilon</code></em> will be considered identical
3328
by <a href="gobject-GParamSpec.html#g-param-values-cmp"><code class="function">g_param_values_cmp()</code></a>; the default value is 1e-90.
3329
3330
</td>
3331
</tr>
3332
</tbody>
3333
</table></div>
3334
</div>
3335
<hr>
3336
<div class="refsect2" lang="en">
3337
<a name="id3107218"></a><h3>
3338
<a name="g-param-spec-double"></a>g_param_spec_double ()</h3>
3339
<a class="indexterm" name="id3107231"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_double (const <a
3340
href="../glib/glib-Basic-Types.html#gchar"
3341
>gchar</a> *name,
3342
const <a
3343
href="../glib/glib-Basic-Types.html#gchar"
3344
>gchar</a> *nick,
3345
const <a
3346
href="../glib/glib-Basic-Types.html#gchar"
3347
>gchar</a> *blurb,
3348
<a
3349
href="../glib/glib-Basic-Types.html#gdouble"
3350
>gdouble</a> minimum,
3351
<a
3352
href="../glib/glib-Basic-Types.html#gdouble"
3353
>gdouble</a> maximum,
3354
<a
3355
href="../glib/glib-Basic-Types.html#gdouble"
3356
>gdouble</a> default_value,
3357
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
3358
<p>
3359
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecDouble"><span class="type">GParamSpecDouble</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><code class="literal">G_TYPE_DOUBLE</code></a>
3360
property.
3361
</p>
3362
<p>
3363
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
3364
</p>
3365
<div class="variablelist"><table border="0">
3366
<col align="left" valign="top">
3367
<tbody>
3368
<tr>
3369
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
3370
<td> canonical name of the property specified
3371
</td>
3372
</tr>
3373
<tr>
3374
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
3375
<td> nick name for the property specified
3376
</td>
3377
</tr>
3378
<tr>
3379
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
3380
<td> description of the property specified
3381
</td>
3382
</tr>
3383
<tr>
3384
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
3385
<td> minimum value for the property specified
3386
</td>
3387
</tr>
3388
<tr>
3389
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
3390
<td> maximum value for the property specified
3391
</td>
3392
</tr>
3393
<tr>
3394
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
3395
<td>default value for the property specified
3396
</td>
3397
</tr>
3398
<tr>
3399
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
3400
<td> flags for the property specified
3401
</td>
3402
</tr>
3403
<tr>
3404
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3405
<td> a newly created parameter specification
3406
3407
3408
</td>
3409
</tr>
3410
</tbody>
3411
</table></div>
3412
</div>
3413
<hr>
3414
<div class="refsect2" lang="en">
3415
<a name="id3107457"></a><h3>
3416
<a name="g-value-set-double"></a>g_value_set_double ()</h3>
3417
<a class="indexterm" name="id3107471"></a><pre class="programlisting">void g_value_set_double (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
3418
<a
3419
href="../glib/glib-Basic-Types.html#gdouble"
3420
>gdouble</a> v_double);</pre>
3421
<p>
3422
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><code class="literal">G_TYPE_DOUBLE</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_double</code></em>.
3423
</p>
3424
<div class="variablelist"><table border="0">
3425
<col align="left" valign="top">
3426
<tbody>
3427
<tr>
3428
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3429
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><code class="literal">G_TYPE_DOUBLE</code></a>
3430
</td>
3431
</tr>
3432
<tr>
3433
<td><span class="term"><em class="parameter"><code>v_double</code></em> :</span></td>
3434
<td>double value to be set
3435
3436
3437
</td>
3438
</tr>
3439
</tbody>
3440
</table></div>
3441
</div>
3442
<hr>
3443
<div class="refsect2" lang="en">
3444
<a name="id3107582"></a><h3>
3445
<a name="g-value-get-double"></a>g_value_get_double ()</h3>
3446
<a class="indexterm" name="id3107595"></a><pre class="programlisting"><a
3447
href="../glib/glib-Basic-Types.html#gdouble"
3448
>gdouble</a> g_value_get_double (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
3449
<p>
3450
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><code class="literal">G_TYPE_DOUBLE</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
3451
</p>
3452
<div class="variablelist"><table border="0">
3453
<col align="left" valign="top">
3454
<tbody>
3455
<tr>
3456
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3457
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><code class="literal">G_TYPE_DOUBLE</code></a>
3458
</td>
3459
</tr>
3460
<tr>
3461
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3462
<td>double contents of <em class="parameter"><code>value</code></em>
3463
3464
3465
</td>
3466
</tr>
3467
</tbody>
3468
</table></div>
3469
</div>
3470
<hr>
3471
<div class="refsect2" lang="en">
3472
<a name="id3107695"></a><h3>
3473
<a name="G-IS-PARAM-SPEC-ENUM:CAPS"></a>G_IS_PARAM_SPEC_ENUM()</h3>
3474
<a class="indexterm" name="id3107708"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_ENUM(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ENUM))
3475
</pre>
3476
<p>
3477
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-ENUM:CAPS"><code class="literal">G_TYPE_PARAM_ENUM</code></a>.
3478
</p>
3479
<div class="variablelist"><table border="0">
3480
<col align="left" valign="top">
3481
<tbody><tr>
3482
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3483
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3484
3485
3486
</td>
3487
</tr></tbody>
3488
</table></div>
3489
</div>
3490
<hr>
3491
<div class="refsect2" lang="en">
3492
<a name="id3107771"></a><h3>
3493
<a name="G-PARAM-SPEC-ENUM:CAPS"></a>G_PARAM_SPEC_ENUM()</h3>
3494
<a class="indexterm" name="id3107784"></a><pre class="programlisting">#define G_PARAM_SPEC_ENUM(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ENUM, GParamSpecEnum))
3495
</pre>
3496
<p>
3497
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecEnum"><span class="type">GParamSpecEnum</span></a>.
3498
</p>
3499
<div class="variablelist"><table border="0">
3500
<col align="left" valign="top">
3501
<tbody><tr>
3502
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3503
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3504
3505
3506
</td>
3507
</tr></tbody>
3508
</table></div>
3509
</div>
3510
<hr>
3511
<div class="refsect2" lang="en">
3512
<a name="id3107844"></a><h3>
3513
<a name="G-VALUE-HOLDS-ENUM:CAPS"></a>G_VALUE_HOLDS_ENUM()</h3>
3514
<a class="indexterm" name="id3107856"></a><pre class="programlisting">#define G_VALUE_HOLDS_ENUM(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ENUM))
3515
</pre>
3516
<p>
3517
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values derived from type <a href="gobject-Type-Information.html#G-TYPE-ENUM:CAPS"><code class="literal">G_TYPE_ENUM</code></a>.
3518
</p>
3519
<div class="variablelist"><table border="0">
3520
<col align="left" valign="top">
3521
<tbody><tr>
3522
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3523
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
3524
3525
3526
</td>
3527
</tr></tbody>
3528
</table></div>
3529
</div>
3530
<hr>
3531
<div class="refsect2" lang="en">
3532
<a name="id3107918"></a><h3>
3533
<a name="G-TYPE-PARAM-ENUM:CAPS"></a>G_TYPE_PARAM_ENUM</h3>
3534
<a class="indexterm" name="id3107932"></a><pre class="programlisting">#define G_TYPE_PARAM_ENUM (g_param_spec_types[10])
3535
</pre>
3536
<p>
3537
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecEnum"><span class="type">GParamSpecEnum</span></a>.
3538
</p>
3539
</div>
3540
<hr>
3541
<div class="refsect2" lang="en">
3542
<a name="id3107964"></a><h3>
3543
<a name="GParamSpecEnum"></a>GParamSpecEnum</h3>
3544
<a class="indexterm" name="id3107976"></a><pre class="programlisting">typedef struct {
3545
GParamSpec parent_instance;
3546
3547
GEnumClass *enum_class;
3548
gint default_value;
3549
} GParamSpecEnum;
3550
</pre>
3551
<p>
3552
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for enum
3553
properties.
3554
</p>
3555
<div class="variablelist"><table border="0">
3556
<col align="left" valign="top">
3557
<tbody>
3558
<tr>
3559
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
3560
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
3561
</td>
3562
</tr>
3563
<tr>
3564
<td><span class="term"><a href="gobject-Enumeration-and-Flag-Types.html#GEnumClass">GEnumClass</a> *<em class="structfield"><code>enum_class</code></em>;</span></td>
3565
<td>the <a href="gobject-Enumeration-and-Flag-Types.html#GEnumClass"><span class="type">GEnumClass</span></a> for the enum
3566
</td>
3567
</tr>
3568
<tr>
3569
<td><span class="term"><a
3570
href="../glib/glib-Basic-Types.html#gint"
3571
>gint</a> <em class="structfield"><code>default_value</code></em>;</span></td>
3572
<td> default value for the property specified
3573
3574
</td>
3575
</tr>
3576
</tbody>
3577
</table></div>
3578
</div>
3579
<hr>
3580
<div class="refsect2" lang="en">
3581
<a name="id3108085"></a><h3>
3582
<a name="g-param-spec-enum"></a>g_param_spec_enum ()</h3>
3583
<a class="indexterm" name="id3108098"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_enum (const <a
3584
href="../glib/glib-Basic-Types.html#gchar"
3585
>gchar</a> *name,
3586
const <a
3587
href="../glib/glib-Basic-Types.html#gchar"
3588
>gchar</a> *nick,
3589
const <a
3590
href="../glib/glib-Basic-Types.html#gchar"
3591
>gchar</a> *blurb,
3592
<a href="gobject-Type-Information.html#GType">GType</a> enum_type,
3593
<a
3594
href="../glib/glib-Basic-Types.html#gint"
3595
>gint</a> default_value,
3596
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
3597
<p>
3598
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecEnum"><span class="type">GParamSpecEnum</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-ENUM:CAPS"><code class="literal">G_TYPE_ENUM</code></a>
3599
property.
3600
</p>
3601
<p>
3602
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
3603
</p>
3604
<div class="variablelist"><table border="0">
3605
<col align="left" valign="top">
3606
<tbody>
3607
<tr>
3608
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
3609
<td> canonical name of the property specified
3610
</td>
3611
</tr>
3612
<tr>
3613
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
3614
<td> nick name for the property specified
3615
</td>
3616
</tr>
3617
<tr>
3618
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
3619
<td> description of the property specified
3620
</td>
3621
</tr>
3622
<tr>
3623
<td><span class="term"><em class="parameter"><code>enum_type</code></em> :</span></td>
3624
<td> a <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> derived from <a href="gobject-Type-Information.html#G-TYPE-ENUM:CAPS"><code class="literal">G_TYPE_ENUM</code></a>
3625
</td>
3626
</tr>
3627
<tr>
3628
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
3629
<td>default value for the property specified
3630
</td>
3631
</tr>
3632
<tr>
3633
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
3634
<td> flags for the property specified
3635
</td>
3636
</tr>
3637
<tr>
3638
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3639
<td> a newly created parameter specification
3640
3641
3642
</td>
3643
</tr>
3644
</tbody>
3645
</table></div>
3646
</div>
3647
<hr>
3648
<div class="refsect2" lang="en">
3649
<a name="id3108320"></a><h3>
3650
<a name="g-value-set-enum"></a>g_value_set_enum ()</h3>
3651
<a class="indexterm" name="id3108333"></a><pre class="programlisting">void g_value_set_enum (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
3652
<a
3653
href="../glib/glib-Basic-Types.html#gint"
3654
>gint</a> v_enum);</pre>
3655
<p>
3656
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-ENUM:CAPS"><code class="literal">G_TYPE_ENUM</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_enum</code></em>.
3657
</p>
3658
<div class="variablelist"><table border="0">
3659
<col align="left" valign="top">
3660
<tbody>
3661
<tr>
3662
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3663
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> whose type is derived from <a href="gobject-Type-Information.html#G-TYPE-ENUM:CAPS"><code class="literal">G_TYPE_ENUM</code></a>
3664
</td>
3665
</tr>
3666
<tr>
3667
<td><span class="term"><em class="parameter"><code>v_enum</code></em> :</span></td>
3668
<td>enum value to be set
3669
3670
3671
</td>
3672
</tr>
3673
</tbody>
3674
</table></div>
3675
</div>
3676
<hr>
3677
<div class="refsect2" lang="en">
3678
<a name="id3108445"></a><h3>
3679
<a name="g-value-get-enum"></a>g_value_get_enum ()</h3>
3680
<a class="indexterm" name="id3108457"></a><pre class="programlisting"><a
3681
href="../glib/glib-Basic-Types.html#gint"
3682
>gint</a> g_value_get_enum (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
3683
<p>
3684
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-ENUM:CAPS"><code class="literal">G_TYPE_ENUM</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
3685
</p>
3686
<div class="variablelist"><table border="0">
3687
<col align="left" valign="top">
3688
<tbody>
3689
<tr>
3690
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3691
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> whose type is derived from <a href="gobject-Type-Information.html#G-TYPE-ENUM:CAPS"><code class="literal">G_TYPE_ENUM</code></a>
3692
</td>
3693
</tr>
3694
<tr>
3695
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3696
<td>enum contents of <em class="parameter"><code>value</code></em>
3697
3698
3699
</td>
3700
</tr>
3701
</tbody>
3702
</table></div>
3703
</div>
3704
<hr>
3705
<div class="refsect2" lang="en">
3706
<a name="id3108557"></a><h3>
3707
<a name="G-IS-PARAM-SPEC-FLAGS:CAPS"></a>G_IS_PARAM_SPEC_FLAGS()</h3>
3708
<a class="indexterm" name="id3108570"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_FLAGS(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLAGS))
3709
</pre>
3710
<p>
3711
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-FLAGS:CAPS"><code class="literal">G_TYPE_PARAM_FLAGS</code></a>.
3712
</p>
3713
<div class="variablelist"><table border="0">
3714
<col align="left" valign="top">
3715
<tbody><tr>
3716
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3717
<td> a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3718
3719
3720
</td>
3721
</tr></tbody>
3722
</table></div>
3723
</div>
3724
<hr>
3725
<div class="refsect2" lang="en">
3726
<a name="id3108633"></a><h3>
3727
<a name="G-PARAM-SPEC-FLAGS:CAPS"></a>G_PARAM_SPEC_FLAGS()</h3>
3728
<a class="indexterm" name="id3108645"></a><pre class="programlisting">#define G_PARAM_SPEC_FLAGS(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLAGS, GParamSpecFlags))
3729
</pre>
3730
<p>
3731
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecFlags"><span class="type">GParamSpecFlags</span></a>.
3732
</p>
3733
<div class="variablelist"><table border="0">
3734
<col align="left" valign="top">
3735
<tbody><tr>
3736
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3737
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3738
3739
3740
</td>
3741
</tr></tbody>
3742
</table></div>
3743
</div>
3744
<hr>
3745
<div class="refsect2" lang="en">
3746
<a name="id3108704"></a><h3>
3747
<a name="G-VALUE-HOLDS-FLAGS:CAPS"></a>G_VALUE_HOLDS_FLAGS()</h3>
3748
<a class="indexterm" name="id3108718"></a><pre class="programlisting">#define G_VALUE_HOLDS_FLAGS(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLAGS))
3749
</pre>
3750
<p>
3751
Returns whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values derived from type <a href="gobject-Type-Information.html#G-TYPE-FLAGS:CAPS"><code class="literal">G_TYPE_FLAGS</code></a>.
3752
</p>
3753
<div class="variablelist"><table border="0">
3754
<col align="left" valign="top">
3755
<tbody><tr>
3756
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3757
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
3758
3759
3760
</td>
3761
</tr></tbody>
3762
</table></div>
3763
</div>
3764
<hr>
3765
<div class="refsect2" lang="en">
3766
<a name="id3108780"></a><h3>
3767
<a name="G-TYPE-PARAM-FLAGS:CAPS"></a>G_TYPE_PARAM_FLAGS</h3>
3768
<a class="indexterm" name="id3108793"></a><pre class="programlisting">#define G_TYPE_PARAM_FLAGS (g_param_spec_types[11])
3769
</pre>
3770
<p>
3771
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecFlags"><span class="type">GParamSpecFlags</span></a>.
3772
</p>
3773
</div>
3774
<hr>
3775
<div class="refsect2" lang="en">
3776
<a name="id3108826"></a><h3>
3777
<a name="GParamSpecFlags"></a>GParamSpecFlags</h3>
3778
<a class="indexterm" name="id3108838"></a><pre class="programlisting">typedef struct {
3779
GParamSpec parent_instance;
3780
3781
GFlagsClass *flags_class;
3782
guint default_value;
3783
} GParamSpecFlags;
3784
</pre>
3785
<p>
3786
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for flags
3787
properties.
3788
</p>
3789
<div class="variablelist"><table border="0">
3790
<col align="left" valign="top">
3791
<tbody>
3792
<tr>
3793
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
3794
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
3795
</td>
3796
</tr>
3797
<tr>
3798
<td><span class="term"><a href="gobject-Enumeration-and-Flag-Types.html#GFlagsClass">GFlagsClass</a> *<em class="structfield"><code>flags_class</code></em>;</span></td>
3799
<td>the <a href="gobject-Enumeration-and-Flag-Types.html#GFlagsClass"><span class="type">GFlagsClass</span></a> for the flags
3800
</td>
3801
</tr>
3802
<tr>
3803
<td><span class="term"><a
3804
href="../glib/glib-Basic-Types.html#guint"
3805
>guint</a> <em class="structfield"><code>default_value</code></em>;</span></td>
3806
<td> default value for the property specified
3807
3808
</td>
3809
</tr>
3810
</tbody>
3811
</table></div>
3812
</div>
3813
<hr>
3814
<div class="refsect2" lang="en">
3815
<a name="id3108946"></a><h3>
3816
<a name="g-param-spec-flags"></a>g_param_spec_flags ()</h3>
3817
<a class="indexterm" name="id3108960"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_flags (const <a
3818
href="../glib/glib-Basic-Types.html#gchar"
3819
>gchar</a> *name,
3820
const <a
3821
href="../glib/glib-Basic-Types.html#gchar"
3822
>gchar</a> *nick,
3823
const <a
3824
href="../glib/glib-Basic-Types.html#gchar"
3825
>gchar</a> *blurb,
3826
<a href="gobject-Type-Information.html#GType">GType</a> flags_type,
3827
<a
3828
href="../glib/glib-Basic-Types.html#guint"
3829
>guint</a> default_value,
3830
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
3831
<p>
3832
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecEnum"><span class="type">GParamSpecEnum</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-FLAGS:CAPS"><code class="literal">G_TYPE_FLAGS</code></a>
3833
property.
3834
</p>
3835
<p>
3836
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
3837
</p>
3838
<div class="variablelist"><table border="0">
3839
<col align="left" valign="top">
3840
<tbody>
3841
<tr>
3842
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
3843
<td> canonical name of the property specified
3844
</td>
3845
</tr>
3846
<tr>
3847
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
3848
<td> nick name for the property specified
3849
</td>
3850
</tr>
3851
<tr>
3852
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
3853
<td> description of the property specified
3854
</td>
3855
</tr>
3856
<tr>
3857
<td><span class="term"><em class="parameter"><code>flags_type</code></em> :</span></td>
3858
<td> a <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> derived from <a href="gobject-Type-Information.html#G-TYPE-FLAGS:CAPS"><code class="literal">G_TYPE_FLAGS</code></a>
3859
</td>
3860
</tr>
3861
<tr>
3862
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
3863
<td>default value for the property specified
3864
</td>
3865
</tr>
3866
<tr>
3867
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
3868
<td> flags for the property specified
3869
</td>
3870
</tr>
3871
<tr>
3872
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3873
<td> a newly created parameter specification
3874
3875
3876
</td>
3877
</tr>
3878
</tbody>
3879
</table></div>
3880
</div>
3881
<hr>
3882
<div class="refsect2" lang="en">
3883
<a name="id3109182"></a><h3>
3884
<a name="g-value-set-flags"></a>g_value_set_flags ()</h3>
3885
<a class="indexterm" name="id3109195"></a><pre class="programlisting">void g_value_set_flags (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
3886
<a
3887
href="../glib/glib-Basic-Types.html#guint"
3888
>guint</a> v_flags);</pre>
3889
<p>
3890
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-FLAGS:CAPS"><code class="literal">G_TYPE_FLAGS</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_flags</code></em>.
3891
</p>
3892
<div class="variablelist"><table border="0">
3893
<col align="left" valign="top">
3894
<tbody>
3895
<tr>
3896
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3897
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> whose type is derived from <a href="gobject-Type-Information.html#G-TYPE-FLAGS:CAPS"><code class="literal">G_TYPE_FLAGS</code></a>
3898
</td>
3899
</tr>
3900
<tr>
3901
<td><span class="term"><em class="parameter"><code>v_flags</code></em> :</span></td>
3902
<td>flags value to be set
3903
3904
3905
</td>
3906
</tr>
3907
</tbody>
3908
</table></div>
3909
</div>
3910
<hr>
3911
<div class="refsect2" lang="en">
3912
<a name="id3109306"></a><h3>
3913
<a name="g-value-get-flags"></a>g_value_get_flags ()</h3>
3914
<a class="indexterm" name="id3109319"></a><pre class="programlisting"><a
3915
href="../glib/glib-Basic-Types.html#guint"
3916
>guint</a> g_value_get_flags (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
3917
<p>
3918
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-FLAGS:CAPS"><code class="literal">G_TYPE_FLAGS</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
3919
</p>
3920
<div class="variablelist"><table border="0">
3921
<col align="left" valign="top">
3922
<tbody>
3923
<tr>
3924
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3925
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> whose type is derived from <a href="gobject-Type-Information.html#G-TYPE-FLAGS:CAPS"><code class="literal">G_TYPE_FLAGS</code></a>
3926
</td>
3927
</tr>
3928
<tr>
3929
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
3930
<td>flags contents of <em class="parameter"><code>value</code></em>
3931
3932
3933
</td>
3934
</tr>
3935
</tbody>
3936
</table></div>
3937
</div>
3938
<hr>
3939
<div class="refsect2" lang="en">
3940
<a name="id3109419"></a><h3>
3941
<a name="G-IS-PARAM-SPEC-STRING:CAPS"></a>G_IS_PARAM_SPEC_STRING()</h3>
3942
<a class="indexterm" name="id3109432"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_STRING(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_STRING))
3943
</pre>
3944
<p>
3945
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-STRING:CAPS"><code class="literal">G_TYPE_PARAM_STRING</code></a>.
3946
</p>
3947
<div class="variablelist"><table border="0">
3948
<col align="left" valign="top">
3949
<tbody><tr>
3950
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3951
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3952
3953
3954
</td>
3955
</tr></tbody>
3956
</table></div>
3957
</div>
3958
<hr>
3959
<div class="refsect2" lang="en">
3960
<a name="id3109495"></a><h3>
3961
<a name="G-PARAM-SPEC-STRING:CAPS"></a>G_PARAM_SPEC_STRING()</h3>
3962
<a class="indexterm" name="id3109508"></a><pre class="programlisting">#define G_PARAM_SPEC_STRING(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_STRING, GParamSpecString))
3963
</pre>
3964
<p>
3965
Casts a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecString"><span class="type">GParamSpecString</span></a>.
3966
</p>
3967
<div class="variablelist"><table border="0">
3968
<col align="left" valign="top">
3969
<tbody><tr>
3970
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
3971
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
3972
3973
3974
</td>
3975
</tr></tbody>
3976
</table></div>
3977
</div>
3978
<hr>
3979
<div class="refsect2" lang="en">
3980
<a name="id3109568"></a><h3>
3981
<a name="G-VALUE-HOLDS-STRING:CAPS"></a>G_VALUE_HOLDS_STRING()</h3>
3982
<a class="indexterm" name="id3109581"></a><pre class="programlisting">#define G_VALUE_HOLDS_STRING(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_STRING))
3983
</pre>
3984
<p>
3985
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>.
3986
</p>
3987
<div class="variablelist"><table border="0">
3988
<col align="left" valign="top">
3989
<tbody><tr>
3990
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
3991
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
3992
3993
3994
</td>
3995
</tr></tbody>
3996
</table></div>
3997
</div>
3998
<hr>
3999
<div class="refsect2" lang="en">
4000
<a name="id3109643"></a><h3>
4001
<a name="G-TYPE-PARAM-STRING:CAPS"></a>G_TYPE_PARAM_STRING</h3>
4002
<a class="indexterm" name="id3109657"></a><pre class="programlisting">#define G_TYPE_PARAM_STRING (g_param_spec_types[14])
4003
</pre>
4004
<p>
4005
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecString"><span class="type">GParamSpecString</span></a>.
4006
</p>
4007
</div>
4008
<hr>
4009
<div class="refsect2" lang="en">
4010
<a name="id3109689"></a><h3>
4011
<a name="GParamSpecString"></a>GParamSpecString</h3>
4012
<a class="indexterm" name="id3109701"></a><pre class="programlisting">typedef struct {
4013
GParamSpec parent_instance;
4014
4015
gchar *default_value;
4016
gchar *cset_first;
4017
gchar *cset_nth;
4018
gchar substitutor;
4019
guint null_fold_if_empty : 1;
4020
guint ensure_non_null : 1;
4021
} GParamSpecString;
4022
</pre>
4023
<p>
4024
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for string
4025
properties.
4026
</p>
4027
<div class="variablelist"><table border="0">
4028
<col align="left" valign="top">
4029
<tbody>
4030
<tr>
4031
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
4032
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
4033
</td>
4034
</tr>
4035
<tr>
4036
<td><span class="term"><a
4037
href="../glib/glib-Basic-Types.html#gchar"
4038
>gchar</a> *<em class="structfield"><code>default_value</code></em>;</span></td>
4039
<td> default value for the property specified
4040
</td>
4041
</tr>
4042
<tr>
4043
<td><span class="term"><a
4044
href="../glib/glib-Basic-Types.html#gchar"
4045
>gchar</a> *<em class="structfield"><code>cset_first</code></em>;</span></td>
4046
<td>a string containing the allowed values for the first byte
4047
</td>
4048
</tr>
4049
<tr>
4050
<td><span class="term"><a
4051
href="../glib/glib-Basic-Types.html#gchar"
4052
>gchar</a> *<em class="structfield"><code>cset_nth</code></em>;</span></td>
4053
<td>a string containing the allowed values for the subsequent bytes
4054
</td>
4055
</tr>
4056
<tr>
4057
<td><span class="term"><a
4058
href="../glib/glib-Basic-Types.html#gchar"
4059
>gchar</a> <em class="structfield"><code>substitutor</code></em>;</span></td>
4060
<td>the replacement byte for bytes which don't match <em class="parameter"><code>cset_first</code></em> or <em class="parameter"><code>cset_nth</code></em>.
4061
</td>
4062
</tr>
4063
<tr>
4064
<td><span class="term"><a
4065
href="../glib/glib-Basic-Types.html#guint"
4066
>guint</a> <em class="structfield"><code>null_fold_if_empty</code></em> : 1;</span></td>
4067
<td>replace empty string by <a
4068
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
4069
><code class="literal">NULL</code></a>
4070
</td>
4071
</tr>
4072
<tr>
4073
<td><span class="term"><a
4074
href="../glib/glib-Basic-Types.html#guint"
4075
>guint</a> <em class="structfield"><code>ensure_non_null</code></em> : 1;</span></td>
4076
<td> replace <a
4077
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
4078
><code class="literal">NULL</code></a> strings by an empty string
4079
4080
</td>
4081
</tr>
4082
</tbody>
4083
</table></div>
4084
</div>
4085
<hr>
4086
<div class="refsect2" lang="en">
4087
<a name="id3109920"></a><h3>
4088
<a name="gchararray"></a>gchararray</h3>
4089
<a class="indexterm" name="id3109933"></a><pre class="programlisting">typedef gchar* gchararray;
4090
</pre>
4091
<p>
4092
A C representable type name for <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a>.
4093
</p>
4094
</div>
4095
<hr>
4096
<div class="refsect2" lang="en">
4097
<a name="id3109957"></a><h3>
4098
<a name="g-param-spec-string"></a>g_param_spec_string ()</h3>
4099
<a class="indexterm" name="id3109970"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_string (const <a
4100
href="../glib/glib-Basic-Types.html#gchar"
4101
>gchar</a> *name,
4102
const <a
4103
href="../glib/glib-Basic-Types.html#gchar"
4104
>gchar</a> *nick,
4105
const <a
4106
href="../glib/glib-Basic-Types.html#gchar"
4107
>gchar</a> *blurb,
4108
const <a
4109
href="../glib/glib-Basic-Types.html#gchar"
4110
>gchar</a> *default_value,
4111
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
4112
<p>
4113
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecString"><span class="type">GParamSpecString</span></a> instance.
4114
</p>
4115
<p>
4116
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
4117
</p>
4118
<div class="variablelist"><table border="0">
4119
<col align="left" valign="top">
4120
<tbody>
4121
<tr>
4122
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
4123
<td> canonical name of the property specified
4124
</td>
4125
</tr>
4126
<tr>
4127
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
4128
<td> nick name for the property specified
4129
</td>
4130
</tr>
4131
<tr>
4132
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
4133
<td> description of the property specified
4134
</td>
4135
</tr>
4136
<tr>
4137
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
4138
<td>default value for the property specified
4139
</td>
4140
</tr>
4141
<tr>
4142
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
4143
<td> flags for the property specified
4144
</td>
4145
</tr>
4146
<tr>
4147
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4148
<td> a newly created parameter specification
4149
4150
4151
</td>
4152
</tr>
4153
</tbody>
4154
</table></div>
4155
</div>
4156
<hr>
4157
<div class="refsect2" lang="en">
4158
<a name="id3110141"></a><h3>
4159
<a name="g-value-set-string"></a>g_value_set_string ()</h3>
4160
<a class="indexterm" name="id3110154"></a><pre class="programlisting">void g_value_set_string (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4161
const <a
4162
href="../glib/glib-Basic-Types.html#gchar"
4163
>gchar</a> *v_string);</pre>
4164
<p>
4165
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_string</code></em>.
4166
</p>
4167
<div class="variablelist"><table border="0">
4168
<col align="left" valign="top">
4169
<tbody>
4170
<tr>
4171
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4172
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>
4173
</td>
4174
</tr>
4175
<tr>
4176
<td><span class="term"><em class="parameter"><code>v_string</code></em> :</span></td>
4177
<td>string to be set
4178
4179
4180
</td>
4181
</tr>
4182
</tbody>
4183
</table></div>
4184
</div>
4185
<hr>
4186
<div class="refsect2" lang="en">
4187
<a name="id3110266"></a><h3>
4188
<a name="g-value-set-static-string"></a>g_value_set_static_string ()</h3>
4189
<a class="indexterm" name="id3110280"></a><pre class="programlisting">void g_value_set_static_string (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4190
const <a
4191
href="../glib/glib-Basic-Types.html#gchar"
4192
>gchar</a> *v_string);</pre>
4193
<p>
4194
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_string</code></em>.
4195
The string is assumed to be static, and is thus not duplicated
4196
when setting the <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
4197
</p>
4198
<div class="variablelist"><table border="0">
4199
<col align="left" valign="top">
4200
<tbody>
4201
<tr>
4202
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4203
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>
4204
</td>
4205
</tr>
4206
<tr>
4207
<td><span class="term"><em class="parameter"><code>v_string</code></em> :</span></td>
4208
<td>static string to be set
4209
4210
4211
</td>
4212
</tr>
4213
</tbody>
4214
</table></div>
4215
</div>
4216
<hr>
4217
<div class="refsect2" lang="en">
4218
<a name="id3110400"></a><h3>
4219
<a name="g-value-take-string"></a>g_value_take_string ()</h3>
4220
<a class="indexterm" name="id3110415"></a><pre class="programlisting">void g_value_take_string (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4221
<a
4222
href="../glib/glib-Basic-Types.html#gchar"
4223
>gchar</a> *v_string);</pre>
4224
<p>
4225
Sets the contents of a <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_string</code></em>.
4226
</p>
4227
<div class="variablelist"><table border="0">
4228
<col align="left" valign="top">
4229
<tbody>
4230
<tr>
4231
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4232
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>
4233
</td>
4234
</tr>
4235
<tr>
4236
<td><span class="term"><em class="parameter"><code>v_string</code></em> :</span></td>
4237
<td>duplicated unowned string to be set
4238
</td>
4239
</tr>
4240
</tbody>
4241
</table></div>
4242
<p class="since">Since 2.4
4243
4244
4245
</p>
4246
</div>
4247
<hr>
4248
<div class="refsect2" lang="en">
4249
<a name="id3110533"></a><h3>
4250
<a name="g-value-set-string-take-ownership"></a>g_value_set_string_take_ownership ()</h3>
4251
<a class="indexterm" name="id3110551"></a><pre class="programlisting">void g_value_set_string_take_ownership (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4252
<a
4253
href="../glib/glib-Basic-Types.html#gchar"
4254
>gchar</a> *v_string);</pre>
4255
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
4256
<h3 class="title">Warning</h3>
4257
<p><code class="literal">g_value_set_string_take_ownership</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-string"><code class="function">g_value_take_string()</code></a> instead.</p>
4258
</div>
4259
<p>
4260
This is an internal function introduced mainly for C marshallers.
4261
</p>
4262
<div class="variablelist"><table border="0">
4263
<col align="left" valign="top">
4264
<tbody>
4265
<tr>
4266
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4267
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>
4268
</td>
4269
</tr>
4270
<tr>
4271
<td><span class="term"><em class="parameter"><code>v_string</code></em> :</span></td>
4272
<td>duplicated unowned string to be set
4273
</td>
4274
</tr>
4275
</tbody>
4276
</table></div>
4277
</div>
4278
<hr>
4279
<div class="refsect2" lang="en">
4280
<a name="id3110663"></a><h3>
4281
<a name="g-value-get-string"></a>g_value_get_string ()</h3>
4282
<a class="indexterm" name="id3110676"></a><pre class="programlisting">const <a
4283
href="../glib/glib-Basic-Types.html#gchar"
4284
>gchar</a>* g_value_get_string (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
4285
<p>
4286
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
4287
</p>
4288
<div class="variablelist"><table border="0">
4289
<col align="left" valign="top">
4290
<tbody>
4291
<tr>
4292
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4293
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>
4294
</td>
4295
</tr>
4296
<tr>
4297
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4298
<td>string content of <em class="parameter"><code>value</code></em>
4299
4300
4301
</td>
4302
</tr>
4303
</tbody>
4304
</table></div>
4305
</div>
4306
<hr>
4307
<div class="refsect2" lang="en">
4308
<a name="id3110777"></a><h3>
4309
<a name="g-value-dup-string"></a>g_value_dup_string ()</h3>
4310
<a class="indexterm" name="id3110790"></a><pre class="programlisting"><a
4311
href="../glib/glib-Basic-Types.html#gchar"
4312
>gchar</a>* g_value_dup_string (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
4313
<p>
4314
Get a copy the contents of a <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
4315
</p>
4316
<div class="variablelist"><table border="0">
4317
<col align="left" valign="top">
4318
<tbody>
4319
<tr>
4320
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4321
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>
4322
</td>
4323
</tr>
4324
<tr>
4325
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4326
<td>a newly allocated copy of the string content of <em class="parameter"><code>value</code></em>
4327
4328
4329
</td>
4330
</tr>
4331
</tbody>
4332
</table></div>
4333
</div>
4334
<hr>
4335
<div class="refsect2" lang="en">
4336
<a name="id3110890"></a><h3>
4337
<a name="G-IS-PARAM-SPEC-PARAM:CAPS"></a>G_IS_PARAM_SPEC_PARAM()</h3>
4338
<a class="indexterm" name="id3110904"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_PARAM(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_PARAM))
4339
</pre>
4340
<p>
4341
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-PARAM:CAPS"><code class="literal">G_TYPE_PARAM_PARAM</code></a>.
4342
</p>
4343
<div class="variablelist"><table border="0">
4344
<col align="left" valign="top">
4345
<tbody><tr>
4346
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
4347
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
4348
4349
4350
</td>
4351
</tr></tbody>
4352
</table></div>
4353
</div>
4354
<hr>
4355
<div class="refsect2" lang="en">
4356
<a name="id3110966"></a><h3>
4357
<a name="G-PARAM-SPEC-PARAM:CAPS"></a>G_PARAM_SPEC_PARAM()</h3>
4358
<a class="indexterm" name="id3110979"></a><pre class="programlisting">#define G_PARAM_SPEC_PARAM(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_PARAM, GParamSpecParam))
4359
</pre>
4360
<p>
4361
Casts a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecParam"><span class="type">GParamSpecParam</span></a>.
4362
</p>
4363
<div class="variablelist"><table border="0">
4364
<col align="left" valign="top">
4365
<tbody><tr>
4366
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
4367
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
4368
4369
4370
</td>
4371
</tr></tbody>
4372
</table></div>
4373
</div>
4374
<hr>
4375
<div class="refsect2" lang="en">
4376
<a name="id3111038"></a><h3>
4377
<a name="G-VALUE-HOLDS-PARAM:CAPS"></a>G_VALUE_HOLDS_PARAM()</h3>
4378
<a class="indexterm" name="id3111052"></a><pre class="programlisting">#define G_VALUE_HOLDS_PARAM(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_PARAM))
4379
</pre>
4380
<p>
4381
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values derived from type <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>.
4382
</p>
4383
<div class="variablelist"><table border="0">
4384
<col align="left" valign="top">
4385
<tbody><tr>
4386
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4387
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
4388
4389
4390
</td>
4391
</tr></tbody>
4392
</table></div>
4393
</div>
4394
<hr>
4395
<div class="refsect2" lang="en">
4396
<a name="id3111113"></a><h3>
4397
<a name="G-TYPE-PARAM-PARAM:CAPS"></a>G_TYPE_PARAM_PARAM</h3>
4398
<a class="indexterm" name="id3111127"></a><pre class="programlisting">#define G_TYPE_PARAM_PARAM (g_param_spec_types[15])
4399
</pre>
4400
<p>
4401
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecParam"><span class="type">GParamSpecParam</span></a>.
4402
</p>
4403
</div>
4404
<hr>
4405
<div class="refsect2" lang="en">
4406
<a name="id3111159"></a><h3>
4407
<a name="GParamSpecParam"></a>GParamSpecParam</h3>
4408
<a class="indexterm" name="id3111172"></a><pre class="programlisting">typedef struct {
4409
GParamSpec parent_instance;
4410
} GParamSpecParam;
4411
</pre>
4412
<p>
4413
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4414
properties.
4415
</p>
4416
<div class="variablelist"><table border="0">
4417
<col align="left" valign="top">
4418
<tbody><tr>
4419
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
4420
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
4421
4422
</td>
4423
</tr></tbody>
4424
</table></div>
4425
</div>
4426
<hr>
4427
<div class="refsect2" lang="en">
4428
<a name="id3111240"></a><h3>
4429
<a name="g-param-spec-param"></a>g_param_spec_param ()</h3>
4430
<a class="indexterm" name="id3111253"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_param (const <a
4431
href="../glib/glib-Basic-Types.html#gchar"
4432
>gchar</a> *name,
4433
const <a
4434
href="../glib/glib-Basic-Types.html#gchar"
4435
>gchar</a> *nick,
4436
const <a
4437
href="../glib/glib-Basic-Types.html#gchar"
4438
>gchar</a> *blurb,
4439
<a href="gobject-Type-Information.html#GType">GType</a> param_type,
4440
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
4441
<p>
4442
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecParam"><span class="type">GParamSpecParam</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4443
property.
4444
</p>
4445
<p>
4446
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
4447
</p>
4448
<div class="variablelist"><table border="0">
4449
<col align="left" valign="top">
4450
<tbody>
4451
<tr>
4452
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
4453
<td> canonical name of the property specified
4454
</td>
4455
</tr>
4456
<tr>
4457
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
4458
<td> nick name for the property specified
4459
</td>
4460
</tr>
4461
<tr>
4462
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
4463
<td> description of the property specified
4464
</td>
4465
</tr>
4466
<tr>
4467
<td><span class="term"><em class="parameter"><code>param_type</code></em> :</span></td>
4468
<td> a <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> derived from <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4469
</td>
4470
</tr>
4471
<tr>
4472
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
4473
<td> flags for the property specified
4474
</td>
4475
</tr>
4476
<tr>
4477
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4478
<td> a newly created parameter specification
4479
</td>
4480
</tr>
4481
</tbody>
4482
</table></div>
4483
</div>
4484
<hr>
4485
<div class="refsect2" lang="en">
4486
<a name="id3111453"></a><h3>
4487
<a name="g-value-set-param"></a>g_value_set_param ()</h3>
4488
<a class="indexterm" name="id3111466"></a><pre class="programlisting">void g_value_set_param (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4489
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *param);</pre>
4490
<p>
4491
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>param</code></em>.
4492
</p>
4493
<div class="variablelist"><table border="0">
4494
<col align="left" valign="top">
4495
<tbody>
4496
<tr>
4497
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4498
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4499
</td>
4500
</tr>
4501
<tr>
4502
<td><span class="term"><em class="parameter"><code>param</code></em> :</span></td>
4503
<td>the <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> to be set
4504
4505
4506
</td>
4507
</tr>
4508
</tbody>
4509
</table></div>
4510
</div>
4511
<hr>
4512
<div class="refsect2" lang="en">
4513
<a name="id3111585"></a><h3>
4514
<a name="g-value-take-param"></a>g_value_take_param ()</h3>
4515
<a class="indexterm" name="id3111601"></a><pre class="programlisting">void g_value_take_param (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4516
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *param);</pre>
4517
<p>
4518
Sets the contents of a <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>param</code></em> and
4519
takes over the ownership of the callers reference to <em class="parameter"><code>param</code></em>;
4520
the caller doesn't have to unref it any more.
4521
</p>
4522
<div class="variablelist"><table border="0">
4523
<col align="left" valign="top">
4524
<tbody>
4525
<tr>
4526
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4527
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4528
</td>
4529
</tr>
4530
<tr>
4531
<td><span class="term"><em class="parameter"><code>param</code></em> :</span></td>
4532
<td>the <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> to be set
4533
</td>
4534
</tr>
4535
</tbody>
4536
</table></div>
4537
<p class="since">Since 2.4
4538
4539
4540
</p>
4541
</div>
4542
<hr>
4543
<div class="refsect2" lang="en">
4544
<a name="id3111734"></a><h3>
4545
<a name="g-value-set-param-take-ownership"></a>g_value_set_param_take_ownership ()</h3>
4546
<a class="indexterm" name="id3111751"></a><pre class="programlisting">void g_value_set_param_take_ownership (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4547
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *param);</pre>
4548
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
4549
<h3 class="title">Warning</h3>
4550
<p><code class="literal">g_value_set_param_take_ownership</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-param"><code class="function">g_value_take_param()</code></a> instead.</p>
4551
</div>
4552
<p>
4553
This is an internal function introduced mainly for C marshallers.
4554
</p>
4555
<div class="variablelist"><table border="0">
4556
<col align="left" valign="top">
4557
<tbody>
4558
<tr>
4559
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4560
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4561
</td>
4562
</tr>
4563
<tr>
4564
<td><span class="term"><em class="parameter"><code>param</code></em> :</span></td>
4565
<td>the <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> to be set
4566
</td>
4567
</tr>
4568
</tbody>
4569
</table></div>
4570
</div>
4571
<hr>
4572
<div class="refsect2" lang="en">
4573
<a name="id3111871"></a><h3>
4574
<a name="g-value-get-param"></a>g_value_get_param ()</h3>
4575
<a class="indexterm" name="id3111884"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_value_get_param (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
4576
<p>
4577
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
4578
</p>
4579
<div class="variablelist"><table border="0">
4580
<col align="left" valign="top">
4581
<tbody>
4582
<tr>
4583
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4584
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> whose type is derived from <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4585
</td>
4586
</tr>
4587
<tr>
4588
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4589
<td>
4590
<a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> content of <em class="parameter"><code>value</code></em>
4591
4592
4593
</td>
4594
</tr>
4595
</tbody>
4596
</table></div>
4597
</div>
4598
<hr>
4599
<div class="refsect2" lang="en">
4600
<a name="id3111990"></a><h3>
4601
<a name="g-value-dup-param"></a>g_value_dup_param ()</h3>
4602
<a class="indexterm" name="id3112003"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_value_dup_param (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
4603
<p>
4604
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>, increasing its reference count.
4605
</p>
4606
<div class="variablelist"><table border="0">
4607
<col align="left" valign="top">
4608
<tbody>
4609
<tr>
4610
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4611
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> whose type is derived from <a href="gobject-Type-Information.html#G-TYPE-PARAM:CAPS"><code class="literal">G_TYPE_PARAM</code></a>
4612
</td>
4613
</tr>
4614
<tr>
4615
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4616
<td>
4617
<a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> content of <em class="parameter"><code>value</code></em>, should be unreferenced when no longer needed.
4618
4619
4620
</td>
4621
</tr>
4622
</tbody>
4623
</table></div>
4624
</div>
4625
<hr>
4626
<div class="refsect2" lang="en">
4627
<a name="id3112111"></a><h3>
4628
<a name="G-IS-PARAM-SPEC-BOXED:CAPS"></a>G_IS_PARAM_SPEC_BOXED()</h3>
4629
<a class="indexterm" name="id3112124"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_BOXED(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOXED))
4630
</pre>
4631
<p>
4632
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-BOXED:CAPS"><code class="literal">G_TYPE_PARAM_BOXED</code></a>.
4633
</p>
4634
<div class="variablelist"><table border="0">
4635
<col align="left" valign="top">
4636
<tbody><tr>
4637
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
4638
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
4639
4640
4641
</td>
4642
</tr></tbody>
4643
</table></div>
4644
</div>
4645
<hr>
4646
<div class="refsect2" lang="en">
4647
<a name="id3112186"></a><h3>
4648
<a name="G-PARAM-SPEC-BOXED:CAPS"></a>G_PARAM_SPEC_BOXED()</h3>
4649
<a class="indexterm" name="id3112199"></a><pre class="programlisting">#define G_PARAM_SPEC_BOXED(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOXED, GParamSpecBoxed))
4650
</pre>
4651
<p>
4652
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoxed"><span class="type">GParamSpecBoxed</span></a>.
4653
</p>
4654
<div class="variablelist"><table border="0">
4655
<col align="left" valign="top">
4656
<tbody><tr>
4657
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
4658
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
4659
4660
4661
</td>
4662
</tr></tbody>
4663
</table></div>
4664
</div>
4665
<hr>
4666
<div class="refsect2" lang="en">
4667
<a name="id3112259"></a><h3>
4668
<a name="G-VALUE-HOLDS-BOXED:CAPS"></a>G_VALUE_HOLDS_BOXED()</h3>
4669
<a class="indexterm" name="id3112272"></a><pre class="programlisting">#define G_VALUE_HOLDS_BOXED(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOXED))
4670
</pre>
4671
<p>
4672
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values derived from type <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a>.
4673
</p>
4674
<div class="variablelist"><table border="0">
4675
<col align="left" valign="top">
4676
<tbody><tr>
4677
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4678
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
4679
4680
4681
</td>
4682
</tr></tbody>
4683
</table></div>
4684
</div>
4685
<hr>
4686
<div class="refsect2" lang="en">
4687
<a name="id3112334"></a><h3>
4688
<a name="G-TYPE-PARAM-BOXED:CAPS"></a>G_TYPE_PARAM_BOXED</h3>
4689
<a class="indexterm" name="id3112348"></a><pre class="programlisting">#define G_TYPE_PARAM_BOXED (g_param_spec_types[16])
4690
</pre>
4691
<p>
4692
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoxed"><span class="type">GParamSpecBoxed</span></a>.
4693
</p>
4694
</div>
4695
<hr>
4696
<div class="refsect2" lang="en">
4697
<a name="id3112380"></a><h3>
4698
<a name="GParamSpecBoxed"></a>GParamSpecBoxed</h3>
4699
<a class="indexterm" name="id3112392"></a><pre class="programlisting">typedef struct {
4700
GParamSpec parent_instance;
4701
} GParamSpecBoxed;
4702
</pre>
4703
<p>
4704
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for boxed properties.
4705
</p>
4706
<div class="variablelist"><table border="0">
4707
<col align="left" valign="top">
4708
<tbody><tr>
4709
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
4710
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
4711
4712
</td>
4713
</tr></tbody>
4714
</table></div>
4715
</div>
4716
<hr>
4717
<div class="refsect2" lang="en">
4718
<a name="id3112450"></a><h3>
4719
<a name="g-param-spec-boxed"></a>g_param_spec_boxed ()</h3>
4720
<a class="indexterm" name="id3112464"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_boxed (const <a
4721
href="../glib/glib-Basic-Types.html#gchar"
4722
>gchar</a> *name,
4723
const <a
4724
href="../glib/glib-Basic-Types.html#gchar"
4725
>gchar</a> *nick,
4726
const <a
4727
href="../glib/glib-Basic-Types.html#gchar"
4728
>gchar</a> *blurb,
4729
<a href="gobject-Type-Information.html#GType">GType</a> boxed_type,
4730
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
4731
<p>
4732
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoxed"><span class="type">GParamSpecBoxed</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a>
4733
derived property.
4734
</p>
4735
<p>
4736
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
4737
</p>
4738
<div class="variablelist"><table border="0">
4739
<col align="left" valign="top">
4740
<tbody>
4741
<tr>
4742
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
4743
<td> canonical name of the property specified
4744
</td>
4745
</tr>
4746
<tr>
4747
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
4748
<td> nick name for the property specified
4749
</td>
4750
</tr>
4751
<tr>
4752
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
4753
<td> description of the property specified
4754
</td>
4755
</tr>
4756
<tr>
4757
<td><span class="term"><em class="parameter"><code>boxed_type</code></em> :</span></td>
4758
<td> <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived type of this property
4759
</td>
4760
</tr>
4761
<tr>
4762
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
4763
<td> flags for the property specified
4764
</td>
4765
</tr>
4766
<tr>
4767
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4768
<td>a newly created parameter specification
4769
4770
4771
</td>
4772
</tr>
4773
</tbody>
4774
</table></div>
4775
</div>
4776
<hr>
4777
<div class="refsect2" lang="en">
4778
<a name="id3112656"></a><h3>
4779
<a name="g-value-set-boxed"></a>g_value_set_boxed ()</h3>
4780
<a class="indexterm" name="id3112670"></a><pre class="programlisting">void g_value_set_boxed (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4781
<a
4782
href="../glib/glib-Basic-Types.html#gconstpointer"
4783
>gconstpointer</a> v_boxed);</pre>
4784
<p>
4785
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_boxed</code></em>.
4786
</p>
4787
<div class="variablelist"><table border="0">
4788
<col align="left" valign="top">
4789
<tbody>
4790
<tr>
4791
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4792
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived type
4793
</td>
4794
</tr>
4795
<tr>
4796
<td><span class="term"><em class="parameter"><code>v_boxed</code></em> :</span></td>
4797
<td>boxed value to be set
4798
4799
4800
</td>
4801
</tr>
4802
</tbody>
4803
</table></div>
4804
</div>
4805
<hr>
4806
<div class="refsect2" lang="en">
4807
<a name="id3112782"></a><h3>
4808
<a name="g-value-set-static-boxed"></a>g_value_set_static_boxed ()</h3>
4809
<a class="indexterm" name="id3112795"></a><pre class="programlisting">void g_value_set_static_boxed (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4810
<a
4811
href="../glib/glib-Basic-Types.html#gconstpointer"
4812
>gconstpointer</a> v_boxed);</pre>
4813
<p>
4814
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_boxed</code></em>.
4815
The boxed value is assumed to be static, and is thus not duplicated
4816
when setting the <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
4817
</p>
4818
<div class="variablelist"><table border="0">
4819
<col align="left" valign="top">
4820
<tbody>
4821
<tr>
4822
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4823
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived type
4824
</td>
4825
</tr>
4826
<tr>
4827
<td><span class="term"><em class="parameter"><code>v_boxed</code></em> :</span></td>
4828
<td>static boxed value to be set
4829
4830
4831
</td>
4832
</tr>
4833
</tbody>
4834
</table></div>
4835
</div>
4836
<hr>
4837
<div class="refsect2" lang="en">
4838
<a name="id3112917"></a><h3>
4839
<a name="g-value-take-boxed"></a>g_value_take_boxed ()</h3>
4840
<a class="indexterm" name="id3112933"></a><pre class="programlisting">void g_value_take_boxed (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4841
<a
4842
href="../glib/glib-Basic-Types.html#gconstpointer"
4843
>gconstpointer</a> v_boxed);</pre>
4844
<p>
4845
Sets the contents of a <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_boxed</code></em> and
4846
takes over the ownership of the callers reference to <em class="parameter"><code>v_boxed</code></em>;
4847
the caller doesn't have to unref it any more.
4848
</p>
4849
<div class="variablelist"><table border="0">
4850
<col align="left" valign="top">
4851
<tbody>
4852
<tr>
4853
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4854
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived type
4855
</td>
4856
</tr>
4857
<tr>
4858
<td><span class="term"><em class="parameter"><code>v_boxed</code></em> :</span></td>
4859
<td>duplicated unowned boxed value to be set
4860
</td>
4861
</tr>
4862
</tbody>
4863
</table></div>
4864
<p class="since">Since 2.4
4865
4866
4867
</p>
4868
</div>
4869
<hr>
4870
<div class="refsect2" lang="en">
4871
<a name="id3113059"></a><h3>
4872
<a name="g-value-set-boxed-take-ownership"></a>g_value_set_boxed_take_ownership ()</h3>
4873
<a class="indexterm" name="id3113076"></a><pre class="programlisting">void g_value_set_boxed_take_ownership (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
4874
<a
4875
href="../glib/glib-Basic-Types.html#gconstpointer"
4876
>gconstpointer</a> v_boxed);</pre>
4877
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
4878
<h3 class="title">Warning</h3>
4879
<p><code class="literal">g_value_set_boxed_take_ownership</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-boxed"><code class="function">g_value_take_boxed()</code></a> instead.</p>
4880
</div>
4881
<p>
4882
This is an internal function introduced mainly for C marshallers.
4883
</p>
4884
<div class="variablelist"><table border="0">
4885
<col align="left" valign="top">
4886
<tbody>
4887
<tr>
4888
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4889
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived type
4890
</td>
4891
</tr>
4892
<tr>
4893
<td><span class="term"><em class="parameter"><code>v_boxed</code></em> :</span></td>
4894
<td>duplicated unowned boxed value to be set
4895
</td>
4896
</tr>
4897
</tbody>
4898
</table></div>
4899
</div>
4900
<hr>
4901
<div class="refsect2" lang="en">
4902
<a name="id3113189"></a><h3>
4903
<a name="g-value-get-boxed"></a>g_value_get_boxed ()</h3>
4904
<a class="indexterm" name="id3113203"></a><pre class="programlisting"><a
4905
href="../glib/glib-Basic-Types.html#gpointer"
4906
>gpointer</a> g_value_get_boxed (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
4907
<p>
4908
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
4909
</p>
4910
<div class="variablelist"><table border="0">
4911
<col align="left" valign="top">
4912
<tbody>
4913
<tr>
4914
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4915
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived type
4916
</td>
4917
</tr>
4918
<tr>
4919
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4920
<td>boxed contents of <em class="parameter"><code>value</code></em>
4921
4922
4923
</td>
4924
</tr>
4925
</tbody>
4926
</table></div>
4927
</div>
4928
<hr>
4929
<div class="refsect2" lang="en">
4930
<a name="id3113303"></a><h3>
4931
<a name="g-value-dup-boxed"></a>g_value_dup_boxed ()</h3>
4932
<a class="indexterm" name="id3113316"></a><pre class="programlisting"><a
4933
href="../glib/glib-Basic-Types.html#gpointer"
4934
>gpointer</a> g_value_dup_boxed (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
4935
<p>
4936
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
4937
Upon getting, the boxed value is duplicated and needs to be
4938
later freed with <a href="gobject-Boxed-Types.html#g-boxed-free"><code class="function">g_boxed_free()</code></a>, e.g. like: g_boxed_free (G_VALUE_TYPE (<em class="parameter"><code>value</code></em>), return_value);
4939
</p>
4940
<div class="variablelist"><table border="0">
4941
<col align="left" valign="top">
4942
<tbody>
4943
<tr>
4944
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
4945
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> derived type
4946
</td>
4947
</tr>
4948
<tr>
4949
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
4950
<td>boxed contents of <em class="parameter"><code>value</code></em>
4951
4952
4953
</td>
4954
</tr>
4955
</tbody>
4956
</table></div>
4957
</div>
4958
<hr>
4959
<div class="refsect2" lang="en">
4960
<a name="id3113434"></a><h3>
4961
<a name="G-IS-PARAM-SPEC-POINTER:CAPS"></a>G_IS_PARAM_SPEC_POINTER()</h3>
4962
<a class="indexterm" name="id3113449"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_POINTER(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_POINTER))
4963
</pre>
4964
<p>
4965
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-POINTER:CAPS"><code class="literal">G_TYPE_PARAM_POINTER</code></a>.
4966
</p>
4967
<div class="variablelist"><table border="0">
4968
<col align="left" valign="top">
4969
<tbody><tr>
4970
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
4971
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
4972
4973
4974
</td>
4975
</tr></tbody>
4976
</table></div>
4977
</div>
4978
<hr>
4979
<div class="refsect2" lang="en">
4980
<a name="id3113511"></a><h3>
4981
<a name="G-PARAM-SPEC-POINTER:CAPS"></a>G_PARAM_SPEC_POINTER()</h3>
4982
<a class="indexterm" name="id3113524"></a><pre class="programlisting">#define G_PARAM_SPEC_POINTER(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_POINTER, GParamSpecPointer))
4983
</pre>
4984
<p>
4985
Casts a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecPointer"><span class="type">GParamSpecPointer</span></a>.
4986
</p>
4987
<div class="variablelist"><table border="0">
4988
<col align="left" valign="top">
4989
<tbody><tr>
4990
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
4991
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
4992
4993
4994
</td>
4995
</tr></tbody>
4996
</table></div>
4997
</div>
4998
<hr>
4999
<div class="refsect2" lang="en">
5000
<a name="id3113584"></a><h3>
5001
<a name="G-VALUE-HOLDS-POINTER:CAPS"></a>G_VALUE_HOLDS_POINTER()</h3>
5002
<a class="indexterm" name="id3113597"></a><pre class="programlisting">#define G_VALUE_HOLDS_POINTER(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_POINTER))
5003
</pre>
5004
<p>
5005
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-POINTER:CAPS"><code class="literal">G_TYPE_POINTER</code></a>.
5006
</p>
5007
<div class="variablelist"><table border="0">
5008
<col align="left" valign="top">
5009
<tbody><tr>
5010
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5011
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
5012
5013
5014
</td>
5015
</tr></tbody>
5016
</table></div>
5017
</div>
5018
<hr>
5019
<div class="refsect2" lang="en">
5020
<a name="id3113659"></a><h3>
5021
<a name="G-TYPE-PARAM-POINTER:CAPS"></a>G_TYPE_PARAM_POINTER</h3>
5022
<a class="indexterm" name="id3113672"></a><pre class="programlisting">#define G_TYPE_PARAM_POINTER (g_param_spec_types[17])
5023
</pre>
5024
<p>
5025
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecPointer"><span class="type">GParamSpecPointer</span></a>.
5026
</p>
5027
</div>
5028
<hr>
5029
<div class="refsect2" lang="en">
5030
<a name="id3113704"></a><h3>
5031
<a name="GParamSpecPointer"></a>GParamSpecPointer</h3>
5032
<a class="indexterm" name="id3113717"></a><pre class="programlisting">typedef struct {
5033
GParamSpec parent_instance;
5034
} GParamSpecPointer;
5035
</pre>
5036
<p>
5037
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for pointer properties.
5038
</p>
5039
<div class="variablelist"><table border="0">
5040
<col align="left" valign="top">
5041
<tbody><tr>
5042
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
5043
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
5044
5045
</td>
5046
</tr></tbody>
5047
</table></div>
5048
</div>
5049
<hr>
5050
<div class="refsect2" lang="en">
5051
<a name="id3113775"></a><h3>
5052
<a name="g-param-spec-pointer"></a>g_param_spec_pointer ()</h3>
5053
<a class="indexterm" name="id3113788"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_pointer (const <a
5054
href="../glib/glib-Basic-Types.html#gchar"
5055
>gchar</a> *name,
5056
const <a
5057
href="../glib/glib-Basic-Types.html#gchar"
5058
>gchar</a> *nick,
5059
const <a
5060
href="../glib/glib-Basic-Types.html#gchar"
5061
>gchar</a> *blurb,
5062
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
5063
<p>
5064
Creates a new <span class="type">GParamSpecPoiner</span> instance specifying a pointer property.
5065
</p>
5066
<p>
5067
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
5068
</p>
5069
<div class="variablelist"><table border="0">
5070
<col align="left" valign="top">
5071
<tbody>
5072
<tr>
5073
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
5074
<td> canonical name of the property specified
5075
</td>
5076
</tr>
5077
<tr>
5078
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
5079
<td> nick name for the property specified
5080
</td>
5081
</tr>
5082
<tr>
5083
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
5084
<td> description of the property specified
5085
</td>
5086
</tr>
5087
<tr>
5088
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
5089
<td> flags for the property specified
5090
</td>
5091
</tr>
5092
<tr>
5093
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5094
<td>a newly created parameter specification
5095
5096
5097
</td>
5098
</tr>
5099
</tbody>
5100
</table></div>
5101
</div>
5102
<hr>
5103
<div class="refsect2" lang="en">
5104
<a name="id3113938"></a><h3>
5105
<a name="g-value-set-pointer"></a>g_value_set_pointer ()</h3>
5106
<a class="indexterm" name="id3113952"></a><pre class="programlisting">void g_value_set_pointer (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
5107
<a
5108
href="../glib/glib-Basic-Types.html#gpointer"
5109
>gpointer</a> v_pointer);</pre>
5110
<p>
5111
Set the contents of a pointer <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_pointer</code></em>.
5112
</p>
5113
<div class="variablelist"><table border="0">
5114
<col align="left" valign="top">
5115
<tbody>
5116
<tr>
5117
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5118
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-POINTER:CAPS"><code class="literal">G_TYPE_POINTER</code></a>
5119
</td>
5120
</tr>
5121
<tr>
5122
<td><span class="term"><em class="parameter"><code>v_pointer</code></em> :</span></td>
5123
<td>pointer value to be set
5124
5125
5126
</td>
5127
</tr>
5128
</tbody>
5129
</table></div>
5130
</div>
5131
<hr>
5132
<div class="refsect2" lang="en">
5133
<a name="id3114052"></a><h3>
5134
<a name="g-value-get-pointer"></a>g_value_get_pointer ()</h3>
5135
<a class="indexterm" name="id3114066"></a><pre class="programlisting"><a
5136
href="../glib/glib-Basic-Types.html#gpointer"
5137
>gpointer</a> g_value_get_pointer (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
5138
<p>
5139
Get the contents of a pointer <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
5140
</p>
5141
<div class="variablelist"><table border="0">
5142
<col align="left" valign="top">
5143
<tbody>
5144
<tr>
5145
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5146
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-POINTER:CAPS"><code class="literal">G_TYPE_POINTER</code></a>
5147
</td>
5148
</tr>
5149
<tr>
5150
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5151
<td>pointer contents of <em class="parameter"><code>value</code></em>
5152
5153
5154
</td>
5155
</tr>
5156
</tbody>
5157
</table></div>
5158
</div>
5159
<hr>
5160
<div class="refsect2" lang="en">
5161
<a name="id3114155"></a><h3>
5162
<a name="G-IS-PARAM-SPEC-OBJECT:CAPS"></a>G_IS_PARAM_SPEC_OBJECT()</h3>
5163
<a class="indexterm" name="id3114168"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_OBJECT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OBJECT))
5164
</pre>
5165
<p>
5166
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-OBJECT:CAPS"><code class="literal">G_TYPE_PARAM_OBJECT</code></a>.
5167
</p>
5168
<div class="variablelist"><table border="0">
5169
<col align="left" valign="top">
5170
<tbody><tr>
5171
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5172
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
5173
5174
5175
</td>
5176
</tr></tbody>
5177
</table></div>
5178
</div>
5179
<hr>
5180
<div class="refsect2" lang="en">
5181
<a name="id3114231"></a><h3>
5182
<a name="G-PARAM-SPEC-OBJECT:CAPS"></a>G_PARAM_SPEC_OBJECT()</h3>
5183
<a class="indexterm" name="id3114244"></a><pre class="programlisting">#define G_PARAM_SPEC_OBJECT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OBJECT, GParamSpecObject))
5184
</pre>
5185
<p>
5186
Casts a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecObject"><span class="type">GParamSpecObject</span></a>.
5187
</p>
5188
<div class="variablelist"><table border="0">
5189
<col align="left" valign="top">
5190
<tbody><tr>
5191
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5192
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
5193
5194
5195
</td>
5196
</tr></tbody>
5197
</table></div>
5198
</div>
5199
<hr>
5200
<div class="refsect2" lang="en">
5201
<a name="id3114303"></a><h3>
5202
<a name="G-VALUE-HOLDS-OBJECT:CAPS"></a>G_VALUE_HOLDS_OBJECT()</h3>
5203
<a class="indexterm" name="id3114316"></a><pre class="programlisting">#define G_VALUE_HOLDS_OBJECT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_OBJECT))
5204
</pre>
5205
<p>
5206
Return whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values derived from type <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a>.
5207
</p>
5208
<div class="variablelist"><table border="0">
5209
<col align="left" valign="top">
5210
<tbody><tr>
5211
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5212
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
5213
5214
5215
</td>
5216
</tr></tbody>
5217
</table></div>
5218
</div>
5219
<hr>
5220
<div class="refsect2" lang="en">
5221
<a name="id3114378"></a><h3>
5222
<a name="G-TYPE-PARAM-OBJECT:CAPS"></a>G_TYPE_PARAM_OBJECT</h3>
5223
<a class="indexterm" name="id3114392"></a><pre class="programlisting">#define G_TYPE_PARAM_OBJECT (g_param_spec_types[19])
5224
</pre>
5225
<p>
5226
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecObject"><span class="type">GParamSpecObject</span></a>.
5227
</p>
5228
</div>
5229
<hr>
5230
<div class="refsect2" lang="en">
5231
<a name="id3114424"></a><h3>
5232
<a name="GParamSpecObject"></a>GParamSpecObject</h3>
5233
<a class="indexterm" name="id3114437"></a><pre class="programlisting">typedef struct {
5234
GParamSpec parent_instance;
5235
} GParamSpecObject;
5236
</pre>
5237
<p>
5238
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for object properties.
5239
</p>
5240
<div class="variablelist"><table border="0">
5241
<col align="left" valign="top">
5242
<tbody><tr>
5243
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
5244
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
5245
5246
</td>
5247
</tr></tbody>
5248
</table></div>
5249
</div>
5250
<hr>
5251
<div class="refsect2" lang="en">
5252
<a name="id3114495"></a><h3>
5253
<a name="g-param-spec-object"></a>g_param_spec_object ()</h3>
5254
<a class="indexterm" name="id3114508"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_object (const <a
5255
href="../glib/glib-Basic-Types.html#gchar"
5256
>gchar</a> *name,
5257
const <a
5258
href="../glib/glib-Basic-Types.html#gchar"
5259
>gchar</a> *nick,
5260
const <a
5261
href="../glib/glib-Basic-Types.html#gchar"
5262
>gchar</a> *blurb,
5263
<a href="gobject-Type-Information.html#GType">GType</a> object_type,
5264
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
5265
<p>
5266
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoxed"><span class="type">GParamSpecBoxed</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a>
5267
derived property.
5268
</p>
5269
<p>
5270
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
5271
</p>
5272
<div class="variablelist"><table border="0">
5273
<col align="left" valign="top">
5274
<tbody>
5275
<tr>
5276
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
5277
<td> canonical name of the property specified
5278
</td>
5279
</tr>
5280
<tr>
5281
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
5282
<td> nick name for the property specified
5283
</td>
5284
</tr>
5285
<tr>
5286
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
5287
<td> description of the property specified
5288
</td>
5289
</tr>
5290
<tr>
5291
<td><span class="term"><em class="parameter"><code>object_type</code></em> :</span></td>
5292
<td> <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived type of this property
5293
</td>
5294
</tr>
5295
<tr>
5296
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
5297
<td> flags for the property specified
5298
</td>
5299
</tr>
5300
<tr>
5301
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5302
<td>a newly created parameter specification
5303
5304
5305
</td>
5306
</tr>
5307
</tbody>
5308
</table></div>
5309
</div>
5310
<hr>
5311
<div class="refsect2" lang="en">
5312
<a name="id3114700"></a><h3>
5313
<a name="g-value-set-object"></a>g_value_set_object ()</h3>
5314
<a class="indexterm" name="id3114714"></a><pre class="programlisting">void g_value_set_object (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
5315
<a
5316
href="../glib/glib-Basic-Types.html#gpointer"
5317
>gpointer</a> v_object);</pre>
5318
<p>
5319
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_object</code></em>.
5320
</p>
5321
<div class="variablelist"><table border="0">
5322
<col align="left" valign="top">
5323
<tbody>
5324
<tr>
5325
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5326
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived type
5327
</td>
5328
</tr>
5329
<tr>
5330
<td><span class="term"><em class="parameter"><code>v_object</code></em> :</span></td>
5331
<td>object value to be set
5332
5333
5334
</td>
5335
</tr>
5336
</tbody>
5337
</table></div>
5338
</div>
5339
<hr>
5340
<div class="refsect2" lang="en">
5341
<a name="id3114825"></a><h3>
5342
<a name="g-value-take-object"></a>g_value_take_object ()</h3>
5343
<a class="indexterm" name="id3114841"></a><pre class="programlisting">void g_value_take_object (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
5344
<a
5345
href="../glib/glib-Basic-Types.html#gpointer"
5346
>gpointer</a> v_object);</pre>
5347
<p>
5348
Sets the contents of a <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_object</code></em>
5349
and takes over the ownership of the callers reference to <em class="parameter"><code>v_object</code></em>;
5350
the caller doesn't have to unref it any more.
5351
</p>
5352
<div class="variablelist"><table border="0">
5353
<col align="left" valign="top">
5354
<tbody>
5355
<tr>
5356
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5357
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived type
5358
</td>
5359
</tr>
5360
<tr>
5361
<td><span class="term"><em class="parameter"><code>v_object</code></em> :</span></td>
5362
<td>object value to be set
5363
</td>
5364
</tr>
5365
</tbody>
5366
</table></div>
5367
<p class="since">Since 2.4
5368
5369
5370
</p>
5371
</div>
5372
<hr>
5373
<div class="refsect2" lang="en">
5374
<a name="id3114967"></a><h3>
5375
<a name="g-value-set-object-take-ownership"></a>g_value_set_object_take_ownership ()</h3>
5376
<a class="indexterm" name="id3114984"></a><pre class="programlisting">void g_value_set_object_take_ownership (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
5377
<a
5378
href="../glib/glib-Basic-Types.html#gpointer"
5379
>gpointer</a> v_object);</pre>
5380
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
5381
<h3 class="title">Warning</h3>
5382
<p><code class="literal">g_value_set_object_take_ownership</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-take-object"><code class="function">g_value_take_object()</code></a> instead.</p>
5383
</div>
5384
<p>
5385
This is an internal function introduced mainly for C marshallers.
5386
</p>
5387
<div class="variablelist"><table border="0">
5388
<col align="left" valign="top">
5389
<tbody>
5390
<tr>
5391
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5392
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived type
5393
</td>
5394
</tr>
5395
<tr>
5396
<td><span class="term"><em class="parameter"><code>v_object</code></em> :</span></td>
5397
<td>object value to be set
5398
</td>
5399
</tr>
5400
</tbody>
5401
</table></div>
5402
</div>
5403
<hr>
5404
<div class="refsect2" lang="en">
5405
<a name="id3115096"></a><h3>
5406
<a name="g-value-get-object"></a>g_value_get_object ()</h3>
5407
<a class="indexterm" name="id3115110"></a><pre class="programlisting"><a
5408
href="../glib/glib-Basic-Types.html#gpointer"
5409
>gpointer</a> g_value_get_object (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
5410
<p>
5411
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
5412
</p>
5413
<div class="variablelist"><table border="0">
5414
<col align="left" valign="top">
5415
<tbody>
5416
<tr>
5417
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5418
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived type
5419
</td>
5420
</tr>
5421
<tr>
5422
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5423
<td>object contents of <em class="parameter"><code>value</code></em>
5424
5425
5426
</td>
5427
</tr>
5428
</tbody>
5429
</table></div>
5430
</div>
5431
<hr>
5432
<div class="refsect2" lang="en">
5433
<a name="id3115210"></a><h3>
5434
<a name="g-value-dup-object"></a>g_value_dup_object ()</h3>
5435
<a class="indexterm" name="id3115223"></a><pre class="programlisting"><a href="gobject-The-Base-Object-Type.html#GObject">GObject</a>* g_value_dup_object (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
5436
<p>
5437
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a> derived <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>, increasing its reference count.
5438
</p>
5439
<div class="variablelist"><table border="0">
5440
<col align="left" valign="top">
5441
<tbody>
5442
<tr>
5443
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5444
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> whose type is derived from <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a>
5445
</td>
5446
</tr>
5447
<tr>
5448
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5449
<td>object content of <em class="parameter"><code>value</code></em>, should be unreferenced when no longer needed.
5450
5451
5452
</td>
5453
</tr>
5454
</tbody>
5455
</table></div>
5456
</div>
5457
<hr>
5458
<div class="refsect2" lang="en">
5459
<a name="id3115325"></a><h3>
5460
<a name="G-IS-PARAM-SPEC-UNICHAR:CAPS"></a>G_IS_PARAM_SPEC_UNICHAR()</h3>
5461
<a class="indexterm" name="id3115339"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_UNICHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UNICHAR))
5462
</pre>
5463
<p>
5464
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-UNICHAR:CAPS"><code class="literal">G_TYPE_PARAM_UNICHAR</code></a>.
5465
</p>
5466
<div class="variablelist"><table border="0">
5467
<col align="left" valign="top">
5468
<tbody><tr>
5469
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5470
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
5471
5472
5473
</td>
5474
</tr></tbody>
5475
</table></div>
5476
</div>
5477
<hr>
5478
<div class="refsect2" lang="en">
5479
<a name="id3115402"></a><h3>
5480
<a name="G-PARAM-SPEC-UNICHAR:CAPS"></a>G_PARAM_SPEC_UNICHAR()</h3>
5481
<a class="indexterm" name="id3115415"></a><pre class="programlisting">#define G_PARAM_SPEC_UNICHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UNICHAR, GParamSpecUnichar))
5482
</pre>
5483
<p>
5484
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUnichar"><span class="type">GParamSpecUnichar</span></a>.
5485
</p>
5486
<div class="variablelist"><table border="0">
5487
<col align="left" valign="top">
5488
<tbody><tr>
5489
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5490
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
5491
5492
5493
</td>
5494
</tr></tbody>
5495
</table></div>
5496
</div>
5497
<hr>
5498
<div class="refsect2" lang="en">
5499
<a name="id3115475"></a><h3>
5500
<a name="G-TYPE-PARAM-UNICHAR:CAPS"></a>G_TYPE_PARAM_UNICHAR</h3>
5501
<a class="indexterm" name="id3115488"></a><pre class="programlisting">#define G_TYPE_PARAM_UNICHAR (g_param_spec_types[9])
5502
</pre>
5503
<p>
5504
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUnichar"><span class="type">GParamSpecUnichar</span></a>.
5505
</p>
5506
</div>
5507
<hr>
5508
<div class="refsect2" lang="en">
5509
<a name="id3115520"></a><h3>
5510
<a name="GParamSpecUnichar"></a>GParamSpecUnichar</h3>
5511
<a class="indexterm" name="id3115533"></a><pre class="programlisting">typedef struct {
5512
GParamSpec parent_instance;
5513
5514
gunichar default_value;
5515
} GParamSpecUnichar;
5516
</pre>
5517
<p>
5518
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for unichar (unsigned integer) properties.
5519
</p>
5520
<div class="variablelist"><table border="0">
5521
<col align="left" valign="top">
5522
<tbody>
5523
<tr>
5524
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
5525
<td>private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
5526
</td>
5527
</tr>
5528
<tr>
5529
<td><span class="term"><a
5530
href="../glib/glib-Unicode-Manipulation.html#gunichar"
5531
>gunichar</a> <em class="structfield"><code>default_value</code></em>;</span></td>
5532
<td> default value for the property specified
5533
5534
</td>
5535
</tr>
5536
</tbody>
5537
</table></div>
5538
</div>
5539
<hr>
5540
<div class="refsect2" lang="en">
5541
<a name="id3115612"></a><h3>
5542
<a name="g-param-spec-unichar"></a>g_param_spec_unichar ()</h3>
5543
<a class="indexterm" name="id3115626"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_unichar (const <a
5544
href="../glib/glib-Basic-Types.html#gchar"
5545
>gchar</a> *name,
5546
const <a
5547
href="../glib/glib-Basic-Types.html#gchar"
5548
>gchar</a> *nick,
5549
const <a
5550
href="../glib/glib-Basic-Types.html#gchar"
5551
>gchar</a> *blurb,
5552
<a
5553
href="../glib/glib-Unicode-Manipulation.html#gunichar"
5554
>gunichar</a> default_value,
5555
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
5556
<p>
5557
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecUnichar"><span class="type">GParamSpecUnichar</span></a> instance specifying a <a href="gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a>
5558
property. <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structures for this property can be accessed with
5559
<a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-uint"><code class="function">g_value_set_uint()</code></a> and <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-uint"><code class="function">g_value_get_uint()</code></a>.
5560
</p>
5561
<p>
5562
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
5563
</p>
5564
<div class="variablelist"><table border="0">
5565
<col align="left" valign="top">
5566
<tbody>
5567
<tr>
5568
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
5569
<td> canonical name of the property specified
5570
</td>
5571
</tr>
5572
<tr>
5573
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
5574
<td> nick name for the property specified
5575
</td>
5576
</tr>
5577
<tr>
5578
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
5579
<td> description of the property specified
5580
</td>
5581
</tr>
5582
<tr>
5583
<td><span class="term"><em class="parameter"><code>default_value</code></em> :</span></td>
5584
<td>default value for the property specified
5585
</td>
5586
</tr>
5587
<tr>
5588
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
5589
<td> flags for the property specified
5590
</td>
5591
</tr>
5592
<tr>
5593
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5594
<td>a newly created parameter specification
5595
5596
5597
</td>
5598
</tr>
5599
</tbody>
5600
</table></div>
5601
</div>
5602
<hr>
5603
<div class="refsect2" lang="en">
5604
<a name="id3115837"></a><h3>
5605
<a name="G-IS-PARAM-SPEC-VALUE-ARRAY:CAPS"></a>G_IS_PARAM_SPEC_VALUE_ARRAY()</h3>
5606
<a class="indexterm" name="id3115851"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_VALUE_ARRAY))
5607
</pre>
5608
<p>
5609
Return whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-VALUE-ARRAY:CAPS"><code class="literal">G_TYPE_PARAM_VALUE_ARRAY</code></a>.
5610
</p>
5611
<div class="variablelist"><table border="0">
5612
<col align="left" valign="top">
5613
<tbody><tr>
5614
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5615
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
5616
5617
5618
</td>
5619
</tr></tbody>
5620
</table></div>
5621
</div>
5622
<hr>
5623
<div class="refsect2" lang="en">
5624
<a name="id3115914"></a><h3>
5625
<a name="G-PARAM-SPEC-VALUE-ARRAY:CAPS"></a>G_PARAM_SPEC_VALUE_ARRAY()</h3>
5626
<a class="indexterm" name="id3115928"></a><pre class="programlisting">#define G_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_VALUE_ARRAY, GParamSpecValueArray))
5627
</pre>
5628
<p>
5629
Cast a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecValueArray"><span class="type">GParamSpecValueArray</span></a>.
5630
</p>
5631
<div class="variablelist"><table border="0">
5632
<col align="left" valign="top">
5633
<tbody><tr>
5634
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5635
<td>a valid <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> instance
5636
5637
5638
</td>
5639
</tr></tbody>
5640
</table></div>
5641
</div>
5642
<hr>
5643
<div class="refsect2" lang="en">
5644
<a name="id3115988"></a><h3>
5645
<a name="G-TYPE-PARAM-VALUE-ARRAY:CAPS"></a>G_TYPE_PARAM_VALUE_ARRAY</h3>
5646
<a class="indexterm" name="id3116002"></a><pre class="programlisting">#define G_TYPE_PARAM_VALUE_ARRAY (g_param_spec_types[18])
5647
</pre>
5648
<p>
5649
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecValueArray"><span class="type">GParamSpecValueArray</span></a>.
5650
</p>
5651
</div>
5652
<hr>
5653
<div class="refsect2" lang="en">
5654
<a name="id3116034"></a><h3>
5655
<a name="GParamSpecValueArray"></a>GParamSpecValueArray</h3>
5656
<a class="indexterm" name="id3116048"></a><pre class="programlisting">typedef struct {
5657
GParamSpec parent_instance;
5658
GParamSpec *element_spec;
5659
guint fixed_n_elements;
5660
} GParamSpecValueArray;
5661
</pre>
5662
<p>
5663
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for <a href="gobject-Value-arrays.html#GValueArray"><span class="type">GValueArray</span></a> properties.
5664
</p>
5665
<div class="variablelist"><table border="0">
5666
<col align="left" valign="top">
5667
<tbody>
5668
<tr>
5669
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
5670
<td> private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
5671
</td>
5672
</tr>
5673
<tr>
5674
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *<em class="structfield"><code>element_spec</code></em>;</span></td>
5675
<td> a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> describing the elements contained in arrays of this property, may be <a
5676
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
5677
><code class="literal">NULL</code></a>
5678
</td>
5679
</tr>
5680
<tr>
5681
<td><span class="term"><a
5682
href="../glib/glib-Basic-Types.html#guint"
5683
>guint</a> <em class="structfield"><code>fixed_n_elements</code></em>;</span></td>
5684
<td>if greater than 0, arrays of this property will always have this many elements
5685
5686
</td>
5687
</tr>
5688
</tbody>
5689
</table></div>
5690
</div>
5691
<hr>
5692
<div class="refsect2" lang="en">
5693
<a name="id3116177"></a><h3>
5694
<a name="g-param-spec-value-array"></a>g_param_spec_value_array ()</h3>
5695
<a class="indexterm" name="id3116190"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_value_array (const <a
5696
href="../glib/glib-Basic-Types.html#gchar"
5697
>gchar</a> *name,
5698
const <a
5699
href="../glib/glib-Basic-Types.html#gchar"
5700
>gchar</a> *nick,
5701
const <a
5702
href="../glib/glib-Basic-Types.html#gchar"
5703
>gchar</a> *blurb,
5704
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *element_spec,
5705
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
5706
<p>
5707
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecValueArray"><span class="type">GParamSpecValueArray</span></a> instance specifying a
5708
<a href="gobject-Generic-values.html#G-TYPE-VALUE-ARRAY:CAPS"><code class="literal">G_TYPE_VALUE_ARRAY</code></a> property. <a href="gobject-Generic-values.html#G-TYPE-VALUE-ARRAY:CAPS"><code class="literal">G_TYPE_VALUE_ARRAY</code></a> is a <a href="gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a>
5709
type, as such, <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structures for this property can be accessed
5710
with <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-boxed"><code class="function">g_value_set_boxed()</code></a> and <a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-boxed"><code class="function">g_value_get_boxed()</code></a>.
5711
</p>
5712
<p>
5713
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
5714
</p>
5715
<div class="variablelist"><table border="0">
5716
<col align="left" valign="top">
5717
<tbody>
5718
<tr>
5719
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
5720
<td> canonical name of the property specified
5721
</td>
5722
</tr>
5723
<tr>
5724
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
5725
<td> nick name for the property specified
5726
</td>
5727
</tr>
5728
<tr>
5729
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
5730
<td> description of the property specified
5731
</td>
5732
</tr>
5733
<tr>
5734
<td><span class="term"><em class="parameter"><code>element_spec</code></em> :</span></td>
5735
<td> a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> describing the elements contained in
5736
arrays of this property, may be <a
5737
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
5738
><code class="literal">NULL</code></a>
5739
</td>
5740
</tr>
5741
<tr>
5742
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
5743
<td> flags for the property specified
5744
</td>
5745
</tr>
5746
<tr>
5747
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5748
<td>a newly created parameter specification
5749
5750
5751
</td>
5752
</tr>
5753
</tbody>
5754
</table></div>
5755
</div>
5756
<hr>
5757
<div class="refsect2" lang="en">
5758
<a name="id3116443"></a><h3>
5759
<a name="G-IS-PARAM-SPEC-OVERRIDE:CAPS"></a>G_IS_PARAM_SPEC_OVERRIDE()</h3>
5760
<a class="indexterm" name="id3116459"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_OVERRIDE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OVERRIDE))
5761
</pre>
5762
<p>
5763
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-OVERRIDE:CAPS"><code class="literal">G_TYPE_PARAM_OVERRIDE</code></a>.
5764
</p>
5765
<div class="variablelist"><table border="0">
5766
<col align="left" valign="top">
5767
<tbody><tr>
5768
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5769
<td>a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>
5770
</td>
5771
</tr></tbody>
5772
</table></div>
5773
<p class="since">Since 2.4
5774
5775
5776
</p>
5777
</div>
5778
<hr>
5779
<div class="refsect2" lang="en">
5780
<a name="id3116528"></a><h3>
5781
<a name="G-PARAM-SPEC-OVERRIDE:CAPS"></a>G_PARAM_SPEC_OVERRIDE()</h3>
5782
<a class="indexterm" name="id3116543"></a><pre class="programlisting">#define G_PARAM_SPEC_OVERRIDE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OVERRIDE, GParamSpecOverride))
5783
</pre>
5784
<p>
5785
Casts a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecOverride"><span class="type">GParamSpecOverride</span></a>.
5786
</p>
5787
<div class="variablelist"><table border="0">
5788
<col align="left" valign="top">
5789
<tbody><tr>
5790
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5791
<td> a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>
5792
</td>
5793
</tr></tbody>
5794
</table></div>
5795
<p class="since">Since 2.4
5796
5797
5798
</p>
5799
</div>
5800
<hr>
5801
<div class="refsect2" lang="en">
5802
<a name="id3116609"></a><h3>
5803
<a name="G-TYPE-PARAM-OVERRIDE:CAPS"></a>G_TYPE_PARAM_OVERRIDE</h3>
5804
<a class="indexterm" name="id3116624"></a><pre class="programlisting">#define G_TYPE_PARAM_OVERRIDE (g_param_spec_types[20])
5805
</pre>
5806
<p>
5807
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecOverride"><span class="type">GParamSpecOverride</span></a>.
5808
</p>
5809
<p class="since">Since 2.4
5810
5811
5812
</p>
5813
</div>
5814
<hr>
5815
<div class="refsect2" lang="en">
5816
<a name="id3116663"></a><h3>
5817
<a name="GParamSpecOverride"></a>GParamSpecOverride</h3>
5818
<a class="indexterm" name="id3116678"></a><pre class="programlisting">typedef struct {
5819
} GParamSpecOverride;
5820
</pre>
5821
<p>
5822
This is a type of <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> type that simply redirects operations to
5823
another paramspec. All operations other than getting or
5824
setting the value are redirected, including accessing the nick and
5825
blurb, validating a value, and so forth. See
5826
<a href="gobject-GParamSpec.html#g-param-spec-get-redirect-target"><code class="function">g_param_spec_get_redirect_target()</code></a> for retrieving the overidden
5827
property. <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecOverride"><span class="type">GParamSpecOverride</span></a> is used in implementing
5828
<a href="gobject-The-Base-Object-Type.html#g-object-class-override-property"><code class="function">g_object_class_override_property()</code></a>, and will not be directly useful
5829
unless you are implementing a new base type similar to GObject.
5830
</p>
5831
<p class="since">Since 2.4
5832
5833
</p>
5834
</div>
5835
<hr>
5836
<div class="refsect2" lang="en">
5837
<a name="id3116745"></a><h3>
5838
<a name="g-param-spec-override"></a>g_param_spec_override ()</h3>
5839
<a class="indexterm" name="id3116761"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_override (const <a
5840
href="../glib/glib-Basic-Types.html#gchar"
5841
>gchar</a> *name,
5842
<a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> *overridden);</pre>
5843
<p>
5844
Creates a new property of type <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecOverride"><span class="type">GParamSpecOverride</span></a>. This is used
5845
to direct operations to another paramspec, and will not be directly
5846
useful unless you are implementing a new base type similar to GObject.
5847
</p>
5848
<div class="variablelist"><table border="0">
5849
<col align="left" valign="top">
5850
<tbody>
5851
<tr>
5852
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
5853
<td>the name of the property.
5854
</td>
5855
</tr>
5856
<tr>
5857
<td><span class="term"><em class="parameter"><code>overridden</code></em> :</span></td>
5858
<td>The property that is being overridden
5859
</td>
5860
</tr>
5861
<tr>
5862
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
5863
<td>the newly created <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>
5864
</td>
5865
</tr>
5866
</tbody>
5867
</table></div>
5868
<p class="since">Since 2.4
5869
5870
5871
</p>
5872
</div>
5873
<hr>
5874
<div class="refsect2" lang="en">
5875
<a name="id3116866"></a><h3>
5876
<a name="G-IS-PARAM-SPEC-GTYPE:CAPS"></a>G_IS_PARAM_SPEC_GTYPE()</h3>
5877
<a class="indexterm" name="id3116882"></a><pre class="programlisting">#define G_IS_PARAM_SPEC_GTYPE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_GTYPE))
5878
</pre>
5879
<p>
5880
Returns whether the given <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> is of type <a href="gobject-Standard-Parameter-and-Value-Types.html#G-TYPE-PARAM-GTYPE:CAPS"><code class="literal">G_TYPE_PARAM_GTYPE</code></a>.
5881
</p>
5882
<div class="variablelist"><table border="0">
5883
<col align="left" valign="top">
5884
<tbody><tr>
5885
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5886
<td>a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>
5887
</td>
5888
</tr></tbody>
5889
</table></div>
5890
<p class="since">Since 2.10
5891
5892
5893
</p>
5894
</div>
5895
<hr>
5896
<div class="refsect2" lang="en">
5897
<a name="id3116951"></a><h3>
5898
<a name="G-PARAM-SPEC-GTYPE:CAPS"></a>G_PARAM_SPEC_GTYPE()</h3>
5899
<a class="indexterm" name="id3116966"></a><pre class="programlisting">#define G_PARAM_SPEC_GTYPE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_GTYPE, GParamSpecGType))
5900
</pre>
5901
<p>
5902
Casts a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> into a <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecGType"><span class="type">GParamSpecGType</span></a>.
5903
</p>
5904
<div class="variablelist"><table border="0">
5905
<col align="left" valign="top">
5906
<tbody><tr>
5907
<td><span class="term"><em class="parameter"><code>pspec</code></em> :</span></td>
5908
<td> a <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>
5909
</td>
5910
</tr></tbody>
5911
</table></div>
5912
<p class="since">Since 2.10
5913
5914
5915
</p>
5916
</div>
5917
<hr>
5918
<div class="refsect2" lang="en">
5919
<a name="id3117032"></a><h3>
5920
<a name="G-VALUE-HOLDS-GTYPE:CAPS"></a>G_VALUE_HOLDS_GTYPE()</h3>
5921
<a class="indexterm" name="id3117047"></a><pre class="programlisting">#define G_VALUE_HOLDS_GTYPE(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_GTYPE))
5922
</pre>
5923
<p>
5924
Returns whether the given <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> can hold values of type <a href="gobject-Type-Information.html#G-TYPE-GTYPE:CAPS"><code class="literal">G_TYPE_GTYPE</code></a>.
5925
</p>
5926
<div class="variablelist"><table border="0">
5927
<col align="left" valign="top">
5928
<tbody><tr>
5929
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
5930
<td> a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> structure
5931
</td>
5932
</tr></tbody>
5933
</table></div>
5934
<p class="since">Since 2.12
5935
5936
5937
</p>
5938
</div>
5939
<hr>
5940
<div class="refsect2" lang="en">
5941
<a name="id3117116"></a><h3>
5942
<a name="G-TYPE-PARAM-GTYPE:CAPS"></a>G_TYPE_PARAM_GTYPE</h3>
5943
<a class="indexterm" name="id3117132"></a><pre class="programlisting">#define G_TYPE_PARAM_GTYPE (g_param_spec_types[21])
5944
</pre>
5945
<p>
5946
The <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> of <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecGType"><span class="type">GParamSpecGType</span></a>.
5947
</p>
5948
<p class="since">Since 2.10
5949
5950
5951
</p>
5952
</div>
5953
<hr>
5954
<div class="refsect2" lang="en">
5955
<a name="id3117171"></a><h3>
5956
<a name="GParamSpecGType"></a>GParamSpecGType</h3>
5957
<a class="indexterm" name="id3117186"></a><pre class="programlisting">typedef struct {
5958
GParamSpec parent_instance;
5959
GType is_a_type;
5960
} GParamSpecGType;
5961
</pre>
5962
<p>
5963
A <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> derived structure that contains the meta data for <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> properties.
5964
</p>
5965
<div class="variablelist"><table border="0">
5966
<col align="left" valign="top">
5967
<tbody>
5968
<tr>
5969
<td><span class="term"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a> <em class="structfield"><code>parent_instance</code></em>;</span></td>
5970
<td> private <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> portion
5971
</td>
5972
</tr>
5973
<tr>
5974
<td><span class="term"><a href="gobject-Type-Information.html#GType">GType</a> <em class="structfield"><code>is_a_type</code></em>;</span></td>
5975
<td> a <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> whose subtypes can occur as values
5976
</td>
5977
</tr>
5978
</tbody>
5979
</table></div>
5980
<p class="since">Since 2.10
5981
5982
</p>
5983
</div>
5984
<hr>
5985
<div class="refsect2" lang="en">
5986
<a name="id3117288"></a><h3>
5987
<a name="g-param-spec-gtype"></a>g_param_spec_gtype ()</h3>
5988
<a class="indexterm" name="id3117303"></a><pre class="programlisting"><a href="gobject-GParamSpec.html#GParamSpec">GParamSpec</a>* g_param_spec_gtype (const <a
5989
href="../glib/glib-Basic-Types.html#gchar"
5990
>gchar</a> *name,
5991
const <a
5992
href="../glib/glib-Basic-Types.html#gchar"
5993
>gchar</a> *nick,
5994
const <a
5995
href="../glib/glib-Basic-Types.html#gchar"
5996
>gchar</a> *blurb,
5997
<a href="gobject-Type-Information.html#GType">GType</a> is_a_type,
5998
<a href="gobject-GParamSpec.html#GParamFlags">GParamFlags</a> flags);</pre>
5999
<p>
6000
Creates a new <a href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecGType"><span class="type">GParamSpecGType</span></a> instance specifying a
6001
<a href="gobject-Type-Information.html#G-TYPE-GTYPE:CAPS"><code class="literal">G_TYPE_GTYPE</code></a> property.
6002
</p>
6003
<p>
6004
See <a href="gobject-GParamSpec.html#g-param-spec-internal"><code class="function">g_param_spec_internal()</code></a> for details on property names.
6005
</p>
6006
<div class="variablelist"><table border="0">
6007
<col align="left" valign="top">
6008
<tbody>
6009
<tr>
6010
<td><span class="term"><em class="parameter"><code>name</code></em> :</span></td>
6011
<td> canonical name of the property specified
6012
</td>
6013
</tr>
6014
<tr>
6015
<td><span class="term"><em class="parameter"><code>nick</code></em> :</span></td>
6016
<td> nick name for the property specified
6017
</td>
6018
</tr>
6019
<tr>
6020
<td><span class="term"><em class="parameter"><code>blurb</code></em> :</span></td>
6021
<td> description of the property specified
6022
</td>
6023
</tr>
6024
<tr>
6025
<td><span class="term"><em class="parameter"><code>is_a_type</code></em> :</span></td>
6026
<td> a <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> whose subtypes are allowed as values
6027
of the property (use <a href="gobject-Type-Information.html#G-TYPE-NONE:CAPS"><code class="literal">G_TYPE_NONE</code></a> for any type)
6028
</td>
6029
</tr>
6030
<tr>
6031
<td><span class="term"><em class="parameter"><code>flags</code></em> :</span></td>
6032
<td> flags for the property specified
6033
</td>
6034
</tr>
6035
<tr>
6036
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
6037
<td>a newly created parameter specification
6038
</td>
6039
</tr>
6040
</tbody>
6041
</table></div>
6042
<p class="since">Since 2.10
6043
6044
6045
</p>
6046
</div>
6047
<hr>
6048
<div class="refsect2" lang="en">
6049
<a name="id3117511"></a><h3>
6050
<a name="g-value-get-gtype"></a>g_value_get_gtype ()</h3>
6051
<a class="indexterm" name="id3117527"></a><pre class="programlisting"><a href="gobject-Type-Information.html#GType">GType</a> g_value_get_gtype (const <a href="gobject-Generic-values.html#GValue">GValue</a> *value);</pre>
6052
<p>
6053
Get the contents of a <a href="gobject-Type-Information.html#G-TYPE-GTYPE:CAPS"><code class="literal">G_TYPE_GTYPE</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
6054
</p>
6055
<div class="variablelist"><table border="0">
6056
<col align="left" valign="top">
6057
<tbody>
6058
<tr>
6059
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
6060
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-GTYPE:CAPS"><code class="literal">G_TYPE_GTYPE</code></a>
6061
</td>
6062
</tr>
6063
<tr>
6064
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
6065
<td>the <a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> stored in <em class="parameter"><code>value</code></em>
6066
</td>
6067
</tr>
6068
</tbody>
6069
</table></div>
6070
<p class="since">Since 2.12
6071
6072
6073
</p>
6074
</div>
6075
<hr>
6076
<div class="refsect2" lang="en">
6077
<a name="id3117641"></a><h3>
6078
<a name="g-value-set-gtype"></a>g_value_set_gtype ()</h3>
6079
<a class="indexterm" name="id3117657"></a><pre class="programlisting">void g_value_set_gtype (<a href="gobject-Generic-values.html#GValue">GValue</a> *value,
6080
<a href="gobject-Type-Information.html#GType">GType</a> v_gtype);</pre>
6081
<p>
6082
Set the contents of a <a href="gobject-Type-Information.html#G-TYPE-GTYPE:CAPS"><code class="literal">G_TYPE_GTYPE</code></a> <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to <em class="parameter"><code>v_gtype</code></em>.
6083
</p>
6084
<div class="variablelist"><table border="0">
6085
<col align="left" valign="top">
6086
<tbody>
6087
<tr>
6088
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
6089
<td>a valid <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="gobject-Type-Information.html#G-TYPE-GTYPE:CAPS"><code class="literal">G_TYPE_GTYPE</code></a>
6090
</td>
6091
</tr>
6092
<tr>
6093
<td><span class="term"><em class="parameter"><code>v_gtype</code></em> :</span></td>
6094
<td>
6095
<a href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> to be set
6096
</td>
6097
</tr>
6098
</tbody>
6099
</table></div>
6100
<p class="since">Since 2.12
6101
6102
6103
</p>
6104
</div>
6105
</div>
6106
<div class="refsect1" lang="en">
6107
<a name="id3117782"></a><h2>See Also</h2>
6108
<p>
6109
<a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>, <a href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>, <a href="gobject-The-Base-Object-Type.html#g-object-class-install-property"><code class="function">g_object_class_install_property()</code></a>.
6110
</p>
6111
</div>
6112
</div>
6113
</body>
6114
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1