Parameters and Values — Standard Parameter and Value Types.
gobject.lib
#include <glib-object.h>
#define G_IS_PARAM_SPEC_BOOLEAN (pspec)
#define G_PARAM_SPEC_BOOLEAN (pspec)
#define G_VALUE_HOLDS_BOOLEAN (value)
#define G_TYPE_PARAM_BOOLEAN
GParamSpecBoolean;
GParamSpec* g_param_spec_boolean (const gchar *name, const gchar *nick, const gchar *blurb, gboolean default_value, GParamFlags flags);
void g_value_set_boolean (GValue *value, gboolean v_boolean);
gboolean g_value_get_boolean (const GValue *value);
#define G_IS_PARAM_SPEC_CHAR (pspec)
#define G_PARAM_SPEC_CHAR (pspec)
#define G_VALUE_HOLDS_CHAR (value)
#define G_TYPE_PARAM_CHAR
GParamSpecChar;
GParamSpec* g_param_spec_char (const gchar *name, const gchar *nick, const gchar *blurb, gint8 minimum, gint8 maximum, gint8 default_value, GParamFlags flags);
void g_value_set_char (GValue *value, gchar v_char);
gchar g_value_get_char (const GValue *value);
#define G_IS_PARAM_SPEC_UCHAR (pspec)
#define G_PARAM_SPEC_UCHAR (pspec)
#define G_VALUE_HOLDS_UCHAR (value)
#define G_TYPE_PARAM_UCHAR
GParamSpecUChar;
GParamSpec* g_param_spec_uchar (const gchar *name, const gchar *nick, const gchar *blurb, guint8 minimum, guint8 maximum, guint8 default_value, GParamFlags flags);
void g_value_set_uchar (GValue *value, guchar v_uchar);
guchar g_value_get_uchar (const GValue *value);
#define G_IS_PARAM_SPEC_INT (pspec)
#define G_PARAM_SPEC_INT (pspec)
#define G_VALUE_HOLDS_INT (value)
#define G_TYPE_PARAM_INT
GParamSpecInt;
GParamSpec* g_param_spec_int (const gchar *name, const gchar *nick, const gchar *blurb, gint minimum,
gint maximum, gint default_value, GParamFlags flags);
void g_value_set_int (GValue *value, gint v_int);
gint g_value_get_int (const GValue *value);
#define G_IS_PARAM_SPEC_UINT (pspec)
#define G_PARAM_SPEC_UINT (pspec)
#define G_VALUE_HOLDS_UINT (value)
#define G_TYPE_PARAM_UINT
GParamSpecUInt;
GParamSpec* g_param_spec_uint (const gchar *name, const gchar *nick, const gchar *blurb, guint minimum,
guint maximum, guint default_value, GParamFlags flags);
void g_value_set_uint (GValue *value, guint v_uint);
guint g_value_get_uint (const GValue *value);
#define G_IS_PARAM_SPEC_LONG (pspec)
#define G_PARAM_SPEC_LONG (pspec)
#define G_VALUE_HOLDS_LONG (value)
#define G_TYPE_PARAM_LONG
GParamSpecLong;
GParamSpec* g_param_spec_long (const gchar *name, const gchar *nick, const gchar *blurb, glong minimum,
glong maximum, glong default_value, GParamFlags flags);
void g_value_set_long (GValue *value, glong v_long);
glong g_value_get_long (const GValue *value);
#define G_IS_PARAM_SPEC_ULONG (pspec)
#define G_PARAM_SPEC_ULONG (pspec)
#define G_VALUE_HOLDS_ULONG (value)
#define G_TYPE_PARAM_ULONG
GParamSpecULong;
GParamSpec* g_param_spec_ulong (const gchar *name, const gchar *nick, const gchar *blurb, gulong minimum,
gulong maximum, gulong default_value, GParamFlags flags);
void g_value_set_ulong (GValue *value, gulong v_ulong);
gulong g_value_get_ulong (const GValue *value);
#define G_IS_PARAM_SPEC_INT64 (pspec)
#define G_PARAM_SPEC_INT64 (pspec)
#define G_VALUE_HOLDS_INT64 (value)
#define G_TYPE_PARAM_INT64
GParamSpecInt64;
GParamSpec* g_param_spec_int64 (const gchar *name, const gchar *nick, const gchar *blurb, gint64 minimum,
gint64 maximum, gint64 default_value, GParamFlags flags);
void g_value_set_int64 (GValue *value, gint64 v_int64);
gint64 g_value_get_int64 (const GValue *value);
#define G_IS_PARAM_SPEC_UINT64 (pspec)
#define G_PARAM_SPEC_UINT64 (pspec)
#define G_VALUE_HOLDS_UINT64 (value)
#define G_TYPE_PARAM_UINT64
GParamSpecUInt64;
GParamSpec* g_param_spec_uint64 (const gchar *name, const gchar *nick, const gchar *blurb, guint64 minimum,
guint64 maximum, guint64 default_value, GParamFlags flags);
void g_value_set_uint64 (GValue *value, guint64 v_uint64);
guint64 g_value_get_uint64 (const GValue *value);
#define G_IS_PARAM_SPEC_FLOAT (pspec)
#define G_PARAM_SPEC_FLOAT (pspec)
#define G_VALUE_HOLDS_FLOAT (value)
#define G_TYPE_PARAM_FLOAT
GParamSpecFloat;
GParamSpec* g_param_spec_float (const gchar *name, const gchar *nick, const gchar *blurb, gfloat minimum,
gfloat maximum, gfloat default_value, GParamFlags flags);
void g_value_set_float (GValue *value, gfloat v_float);
gfloat g_value_get_float (const GValue *value);
#define G_IS_PARAM_SPEC_DOUBLE (pspec)
#define G_PARAM_SPEC_DOUBLE (pspec)
#define G_VALUE_HOLDS_DOUBLE (value)
#define G_TYPE_PARAM_DOUBLE
GParamSpecDouble;
GParamSpec* g_param_spec_double (const gchar *name, const gchar *nick, const gchar *blurb, gdouble minimum, gdouble maximum, gdouble default_value, GParamFlags flags);
void g_value_set_double (GValue *value, gdouble v_double);
gdouble g_value_get_double (const GValue *value);
#define G_IS_PARAM_SPEC_ENUM (pspec)
#define G_PARAM_SPEC_ENUM (pspec)
#define G_VALUE_HOLDS_ENUM (value)
#define G_TYPE_PARAM_ENUM
GParamSpecEnum;
GParamSpec* g_param_spec_enum (const gchar *name, const gchar *nick, const gchar *blurb, GType enum_type,
gint default_value, GParamFlags flags);
void g_value_set_enum (GValue *value, gint v_enum);
gint g_value_get_enum (const GValue *value);
#define G_IS_PARAM_SPEC_FLAGS (pspec)
#define G_PARAM_SPEC_FLAGS (pspec)
#define G_VALUE_HOLDS_FLAGS (value)
#define G_TYPE_PARAM_FLAGS
GParamSpecFlags;
GParamSpec* g_param_spec_flags (const gchar *name, const gchar *nick, const gchar *blurb, GType flags_type, guint default_value, GParamFlags flags);
void g_value_set_flags (GValue *value, guint v_flags);
guint g_value_get_flags (const GValue *value);
#define G_IS_PARAM_SPEC_STRING (pspec)
#define G_PARAM_SPEC_STRING (pspec)
#define G_VALUE_HOLDS_STRING (value)
#define G_TYPE_PARAM_STRING
GParamSpecString;
typedef gchararray;
GParamSpec* g_param_spec_string (const gchar *name, const gchar *nick, const gchar *blurb, const gchar *default_value, GParamFlags flags);
void g_value_set_string (GValue *value, const gchar *v_string);
void g_value_set_static_string (GValue *value, const gchar *v_string);
void g_value_take_string (GValue *value, gchar *v_string);
void g_value_set_string_take_ownership (GValue *value, gchar *v_string);
const gchar* g_value_get_string (const GValue *value);
gchar* g_value_dup_string (const GValue *value);
#define G_IS_PARAM_SPEC_PARAM (pspec)
#define G_PARAM_SPEC_PARAM (pspec)
#define G_VALUE_HOLDS_PARAM (value)
#define G_TYPE_PARAM_PARAM
GParamSpecParam;
GParamSpec* g_param_spec_param (const gchar *name, const gchar *nick, const gchar *blurb, GType param_type, GParamFlags flags);
void g_value_set_param (GValue *value, GParamSpec *param);
void g_value_take_param (GValue *value, GParamSpec *param);
void g_value_set_param_take_ownership (GValue *value, GParamSpec *param);
GParamSpec* g_value_get_param (const GValue *value);
GParamSpec* g_value_dup_param (const GValue *value);
#define G_IS_PARAM_SPEC_BOXED (pspec)
#define G_PARAM_SPEC_BOXED (pspec)
#define G_VALUE_HOLDS_BOXED (value)
#define G_TYPE_PARAM_BOXED
GParamSpecBoxed;
GParamSpec* g_param_spec_boxed (const gchar *name, const gchar *nick, const gchar *blurb, GType boxed_type, GParamFlags flags);
void g_value_set_boxed (GValue *value, gconstpointer v_boxed);
void g_value_set_static_boxed (GValue *value, gconstpointer v_boxed);
void g_value_take_boxed (GValue *value, gconstpointer v_boxed);
void g_value_set_boxed_take_ownership (GValue *value, gconstpointer v_boxed);
gpointer g_value_get_boxed (const GValue *value);
gpointer g_value_dup_boxed (const GValue *value);
#define G_IS_PARAM_SPEC_POINTER (pspec)
#define G_PARAM_SPEC_POINTER (pspec)
#define G_VALUE_HOLDS_POINTER (value)
#define G_TYPE_PARAM_POINTER
GParamSpecPointer;
GParamSpec* g_param_spec_pointer (const gchar *name, const gchar *nick, const gchar *blurb, GParamFlags flags);
void g_value_set_pointer (GValue *value, gpointer v_pointer);
gpointer g_value_get_pointer (const GValue *value);
#define G_IS_PARAM_SPEC_OBJECT (pspec)
#define G_PARAM_SPEC_OBJECT (pspec)
#define G_VALUE_HOLDS_OBJECT (value)
#define G_TYPE_PARAM_OBJECT
GParamSpecObject;
GParamSpec* g_param_spec_object (const gchar *name, const gchar *nick, const gchar *blurb, GType object_type, GParamFlags flags);
void g_value_set_object (GValue *value, gpointer v_object);
void g_value_take_object (GValue *value, gpointer v_object);
void g_value_set_object_take_ownership (GValue *value, gpointer v_object);
gpointer g_value_get_object (const GValue *value);
GObject* g_value_dup_object (const GValue *value);
#define G_IS_PARAM_SPEC_UNICHAR (pspec)
#define G_PARAM_SPEC_UNICHAR (pspec)
#define G_TYPE_PARAM_UNICHAR
GParamSpecUnichar;
GParamSpec* g_param_spec_unichar (const gchar *name, const gchar *nick, const gchar *blurb, gunichar default_value, GParamFlags flags);
#define G_IS_PARAM_SPEC_VALUE_ARRAY (pspec)
#define G_PARAM_SPEC_VALUE_ARRAY (pspec)
#define G_TYPE_PARAM_VALUE_ARRAY
GParamSpecValueArray;
GParamSpec* g_param_spec_value_array (const gchar *name, const gchar *blurb, GParamSpec *element_spec, const gchar *nick, GParamFlags flags);
#define G_IS_PARAM_SPEC_OVERRIDE (pspec)
#define G_PARAM_SPEC_OVERRIDE (pspec)
#define G_TYPE_PARAM_OVERRIDE
GParamSpecOverride;
GParamSpec* g_param_spec_override (const gchar *name, GParamSpec *overridden);
#define G_IS_PARAM_SPEC_GTYPE (pspec) #define G_PARAM_SPEC_GTYPE (pspec) #define G_TYPE_PARAM_GTYPE GParamSpecGType; GParamSpec* g_param_spec_gtype (const gchar *name, const gchar *nick, const gchar *blurb, GType is_a_type, GParamFlags flags);
GValue provides an abstract container structure which can be copied, transformed and compared while holding a value of any (derived) type, which is registered as a GType with a GTypeValueTable in its GTypeInfo structure. Parameter specifications for most value types can be created as GParamSpec derived instances, to implement e.g. GObject properties which operate on GValue containers.
Parameter names need to start with a letter (a-z or
A-Z). Subsequent characters can be letters, numbers or a '-'. All other
characters are replaced by a '-' during construction.
#define G_IS_PARAM_SPEC_BOOLEAN(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOOLEAN))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_BOOLEAN
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_BOOLEAN(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOOLEAN, GParamSpecBoolean))
Casts a GParamSpec instance into a GParamSpecBoolean.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_BOOLEAN(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOOLEAN))
Returns whether the given GValue can hold values of type G_TYPE_BOOLEAN
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_BOOLEAN (g_param_spec_types[2])
The GType of GParamSpecBoolean.
typedef struct {
GParamSpec parent_instance;
gboolean default_value;
} GParamSpecBoolean;
A GParamSpec derived structure that contains the meta data for boolean properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gboolean default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_boolean (const gchar *name, const gchar *nick, const gchar *blurb, gboolean default_value, GParamFlags flags);
Creates a new GParamSpecBoolean instance specifying a G_TYPE_BOOLEAN
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_boolean (GValue *value, gboolean v_boolean);
Sets the contents of a
G_TYPE_BOOLEAN
GValue
to v_boolean
.
value : |
a valid GValue of type G_TYPE_BOOLEAN
|
v_boolean : |
boolean value to be set |
gboolean g_value_get_boolean (const GValue *value);
Gets the contents of a
G_TYPE_BOOLEAN
GValue.
value : |
a valid GValue of type G_TYPE_BOOLEAN
|
Returns : | boolean contents of value
|
#define G_IS_PARAM_SPEC_CHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_CHAR))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_CHAR
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_CHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_CHAR, GParamSpecChar))
Casts a GParamSpec instance into a GParamSpecChar.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_CHAR(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_CHAR))
Returns whether the given GValue can hold values of type G_TYPE_CHAR
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
gint8 minimum;
gint8 maximum;
gint8 default_value;
} GParamSpecChar;
A GParamSpec derived structure that contains the meta data for character properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gint8 minimum ; |
minimum value for the property specified |
gint8 maximum ; |
maximum value for the property specified |
gint8 default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_char (const gchar *name, const gchar *nick, const gchar *blurb, gint8 minimum, gint8 maximum, gint8 default_value, GParamFlags flags);
Creates a new GParamSpecChar instance specifying a G_TYPE_CHAR
property.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_char (GValue *value, gchar v_char);
Sets the contents of a G_TYPE_CHAR
GValue
to v_char
.
value : |
a valid GValue of type
G_TYPE_CHAR
|
v_char : |
character value to be set |
gchar g_value_get_char (const GValue *value);
Gets the contents of a G_TYPE_CHAR
GValue.
value : |
a valid GValue of type
G_TYPE_CHAR
|
Returns : | character contents of value
|
#define G_IS_PARAM_SPEC_UCHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UCHAR))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_UCHAR
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_UCHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UCHAR, GParamSpecUChar))
Casts a GParamSpec instance into a GParamSpecUChar.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_UCHAR(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UCHAR))
Returns whether the given GValue can hold values of type G_TYPE_UCHAR
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
guint8 minimum;
guint8 maximum;
guint8 default_value;
} GParamSpecUChar;
A GParamSpec derived structure that contains the meta data for unsigned character properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
guint8 minimum ; |
minimum value for the property specified |
guint8 maximum ; |
maximum value for the property specified |
guint8 default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_uchar (const gchar *name, const gchar *nick, const gchar *blurb, guint8 minimum, guint8 maximum,
guint8 default_value, GParamFlags flags);
Creates a new GParamSpecUChar instance specifying a G_TYPE_UCHAR
property.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_uchar (GValue *value, guchar v_uchar);
Sets the contents of a G_TYPE_UCHAR
GValue
to v_uchar
.
value : |
a valid GValue of type
G_TYPE_UCHAR
|
v_uchar : |
unsigned character value to be set |
guchar g_value_get_uchar (const GValue *value);
Gets the contents of a G_TYPE_UCHAR
GValue.
value : |
a valid GValue of type
G_TYPE_UCHAR
|
Returns : | unsigned character contents of value
|
#define G_IS_PARAM_SPEC_INT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_INT
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_INT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT, GParamSpecInt))
Casts a GParamSpec instance into a GParamSpecInt.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_INT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT))
Returns whether the given GValue can hold values of type G_TYPE_INT
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
gint minimum;
gint maximum;
gint default_value;
} GParamSpecInt;
A GParamSpec derived structure that contains the meta data for integer properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gint minimum ; |
minimum value for the property specified |
gint maximum ; |
maximum value for the property specified |
gint default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_int (const gchar *name, const gchar *nick, const gchar *blurb, gint minimum,
gint maximum, gint default_value, GParamFlags flags);
Creates a new GParamSpecInt instance specifying a G_TYPE_INT
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_int (GValue *value, gint v_int);
Sets the contents of a
G_TYPE_INT
GValue
to v_int
.
value : |
a valid GValue of type G_TYPE_INT
|
v_int : |
integer value to be set |
gint g_value_get_int (const GValue *value);
Gets the contents of a
G_TYPE_INT
GValue.
value : |
a valid GValue of type G_TYPE_INT
|
Returns : | integer contents of value
|
#define G_IS_PARAM_SPEC_UINT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_INT
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_UINT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT, GParamSpecUInt))
Casts a GParamSpec instance into a GParamSpecUInt.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_UINT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT))
Returns whether the given GValue can hold values of type
G_TYPE_UINT
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
guint minimum;
guint maximum;
guint default_value;
} GParamSpecUInt;
A GParamSpec derived structure that contains the meta data for unsigned integer properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
guint minimum ; |
minimum value for the property specified |
guint maximum ; |
maximum value for the property specified |
guint default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_uint (const gchar *name, const gchar *nick, const gchar *blurb, guint minimum, guint maximum,
guint default_value, GParamFlags flags);
Creates a new GParamSpecUInt instance specifying a
G_TYPE_UINT
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_uint (GValue *value, guint v_uint);
Sets the contents of a
G_TYPE_UINT
GValue
to v_uint
.
value : |
a valid GValue of type G_TYPE_UINT
|
v_uint : |
unsigned integer value to be set |
guint g_value_get_uint (const GValue *value);
Gets the contents of a G_TYPE_UINT
GValue.
value : |
a valid GValue of type G_TYPE_UINT
|
Returns : | unsigned integer contents of value
|
#define G_IS_PARAM_SPEC_LONG(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_LONG))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_LONG
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_LONG(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_LONG, GParamSpecLong))
Casts a GParamSpec instance into a GParamSpecLong.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_LONG(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_LONG))
Returns whether the given GValue can hold values of type
G_TYPE_LONG
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
glong minimum;
glong maximum;
glong default_value;
} GParamSpecLong;
A GParamSpec derived structure that contains the meta data for long integer properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
glong minimum ; |
minimum value for the property specified |
glong maximum ; |
maximum value for the property specified |
glong default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_long (const gchar *name, const gchar *nick, const gchar *blurb, glong minimum,
glong maximum, glong default_value, GParamFlags flags);
Creates a new GParamSpecLong instance specifying a
G_TYPE_LONG
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_long (GValue *value, glong v_long);
Sets the contents of a
G_TYPE_LONG
GValue
to v_long
.
value : |
a valid GValue of type G_TYPE_LONG
|
v_long : |
long integer value to be set |
glong g_value_get_long (const GValue *value);
Gets the contents of a G_TYPE_LONG
GValue.
value : |
a valid GValue of type G_TYPE_LONG
|
Returns : | long integer contents of value
|
#define G_IS_PARAM_SPEC_ULONG(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ULONG))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_ULONG
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_ULONG(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ULONG, GParamSpecULong))
Casts a GParamSpec instance into a GParamSpecULong.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_ULONG(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ULONG))
Returns whether the given GValue can hold values of type G_TYPE_ULONG
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
gulong minimum;
gulong maximum;
gulong default_value;
} GParamSpecULong;
A GParamSpec derived structure that contains the meta data for unsigned long integer properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gulong minimum ; |
minimum value for the property specified |
gulong maximum ; |
maximum value for the property specified |
gulong default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_ulong (const gchar *name, const gchar *nick, const gchar *blurb, gulong minimum,
gulong maximum, gulong default_value, GParamFlags flags);
Creates a new GParamSpecULong instance specifying a G_TYPE_ULONG
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_ulong (GValue *value, gulong v_ulong);
Sets the contents of a G_TYPE_ULONG
GValue
to v_ulong
.
value : |
a valid GValue of type
G_TYPE_ULONG
|
v_ulong : |
unsigned long integer value to be set |
gulong g_value_get_ulong (const GValue *value);
Gets the contents of a G_TYPE_ULONG
GValue.
value : |
a valid GValue of type
G_TYPE_ULONG
|
Returns : | unsigned long integer contents of value
|
#define G_IS_PARAM_SPEC_INT64(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT64))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_INT64
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_INT64(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT64, GParamSpecInt64))
Casts a GParamSpec instance into a GParamSpecInt64.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_INT64(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT64))
Returns whether the given GValue can hold values of type G_TYPE_INT64
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
gint64 minimum;
gint64 maximum;
gint64 default_value;
} GParamSpecInt64;
A GParamSpec derived structure that contains the meta data for 64bit integer properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gint64 minimum ; |
minimum value for the property specified |
gint64 maximum ; |
maximum value for the property specified |
gint64 default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_int64 (const gchar *name, const gchar *nick, const gchar *blurb, gint64 minimum,
gint64 maximum, gint64 default_value, GParamFlags flags);
Creates a new GParamSpecInt64 instance specifying a G_TYPE_INT64
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_int64 (GValue *value, gint64 v_int64);
Sets the contents of a G_TYPE_INT64
GValue
to v_int64
.
value : |
a valid GValue of type
G_TYPE_INT64
|
v_int64 : |
64bit integer value to be set |
gint64 g_value_get_int64 (const GValue *value);
Gets the contents of a G_TYPE_INT64
GValue.
value : |
a valid GValue of type
G_TYPE_INT64
|
Returns : | 64bit integer contents of value
|
#define G_IS_PARAM_SPEC_UINT64(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT64))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_UINT64
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_UINT64(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT64, GParamSpecUInt64))
Casts a GParamSpec instance into a GParamSpecUInt64.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_UINT64(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT64))
Returns whether the given GValue can hold values of type G_TYPE_UINT64
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_UINT64 (g_param_spec_types[8])
The GType of GParamSpecUInt64.
typedef struct {
GParamSpec parent_instance;
guint64 minimum;
guint64 maximum;
guint64 default_value;
} GParamSpecUInt64;
A GParamSpec derived structure that contains the meta data for unsigned 64bit integer properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
guint64 minimum ; |
minimum value for the property specified |
guint64 maximum ; |
maximum value for the property specified |
guint64 default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_uint64 (const gchar *name, const gchar *nick, const gchar *blurb, guint64 minimum, guint64 maximum,
guint64 default_value, GParamFlags flags);
Creates a new GParamSpecUInt64 instance specifying a G_TYPE_UINT64
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_uint64 (GValue *value, guint64 v_uint64);
Sets the contents of a G_TYPE_UINT64
GValue
to v_uint64
.
value : |
a valid GValue of type G_TYPE_UINT64
|
v_uint64 : |
unsigned 64bit integer value to be set |
guint64 g_value_get_uint64 (const GValue *value);
Gets the contents of a G_TYPE_UINT64
GValue.
value : |
a valid GValue of type G_TYPE_UINT64
|
Returns : | unsigned 64bit integer contents of value
|
#define G_IS_PARAM_SPEC_FLOAT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLOAT))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_FLOAT
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_FLOAT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLOAT, GParamSpecFloat))
Casts a GParamSpec instance into a GParamSpecFloat.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_FLOAT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLOAT))
Returns whether the given GValue can hold values of type G_TYPE_FLOAT
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_FLOAT (g_param_spec_types[12])
The GType of GParamSpecFloat.
typedef struct {
GParamSpec parent_instance;
gfloat minimum;
gfloat maximum;
gfloat default_value;
gfloat epsilon;
} GParamSpecFloat;
A GParamSpec derived structure that contains the meta data for float properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gfloat minimum ; |
minimum value for the property specified |
gfloat maximum ; |
maximum value for the property specified |
gfloat default_value ; |
default value for the property specified |
gfloat epsilon ; |
values closer than epsilon
will be considered identical by g_param_values_cmp() ; the default value is 1e-30.
|
GParamSpec* g_param_spec_float (const gchar *name, const gchar *nick, const gchar *blurb, gfloat minimum,
gfloat maximum, gfloat default_value, GParamFlags flags);
Creates a new GParamSpecFloat instance specifying a G_TYPE_FLOAT
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_float (GValue *value, gfloat v_float);
Sets the contents of a G_TYPE_FLOAT
GValue
to v_float
.
value : |
a valid GValue of type G_TYPE_FLOAT
|
v_float : |
float value to be set |
gfloat g_value_get_float (const GValue *value);
Gets the contents of a G_TYPE_FLOAT
GValue.
value : |
a valid GValue of type G_TYPE_FLOAT
|
Returns : | float contents of value
|
#define G_IS_PARAM_SPEC_DOUBLE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_DOUBLE))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_DOUBLE
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_DOUBLE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_DOUBLE, GParamSpecDouble))
Casts a GParamSpec instance into a GParamSpecDouble.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_DOUBLE(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_DOUBLE))
Returns whether the given GValue can hold values of type G_TYPE_DOUBLE
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_DOUBLE (g_param_spec_types[13])
The GType of GParamSpecDouble.
typedef struct {
GParamSpec parent_instance;
gdouble minimum;
gdouble maximum;
gdouble default_value;
gdouble epsilon;
} GParamSpecDouble;
A GParamSpec derived structure that contains the meta data for double properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gdouble minimum ; |
minimum value for the property specified |
gdouble maximum ; |
maximum value for the property specified |
gdouble default_value ; |
default value for the property specified |
gdouble epsilon ; |
values closer than epsilon
will be considered identical by g_param_values_cmp() ; the default value is 1e-90.
|
GParamSpec* g_param_spec_double (const gchar *name, const gchar *nick, const gchar *blurb, gdouble minimum, gdouble maximum,
gdouble default_value, GParamFlags flags);
Creates a new GParamSpecDouble instance specifying a G_TYPE_DOUBLE
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
minimum : |
minimum value for the property specified |
maximum : |
maximum value for the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_double (GValue *value, gdouble v_double);
Sets the contents of a G_TYPE_DOUBLE
GValue
to v_double
.
value : |
a valid GValue of type G_TYPE_DOUBLE
|
v_double : |
double value to be set |
gdouble g_value_get_double (const GValue *value);
Gets the contents of a G_TYPE_DOUBLE
GValue.
value : |
a valid GValue of type G_TYPE_DOUBLE
|
Returns : | double contents of value
|
#define G_IS_PARAM_SPEC_ENUM(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ENUM))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_ENUM
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_ENUM(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ENUM, GParamSpecEnum))
Casts a GParamSpec instance into a GParamSpecEnum.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_ENUM(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ENUM))
Returns whether the given GValue can hold values derived from type G_TYPE_ENUM
.
value : |
a valid GValue structure |
typedef struct {
GParamSpec parent_instance;
GEnumClass *enum_class;
gint default_value;
} GParamSpecEnum;
A GParamSpec derived structure that contains the meta data for enum properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GEnumClass *enum_class ; |
the GEnumClass for the enum |
gint default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_enum (const gchar *name, const gchar *nick, const gchar *blurb, GType enum_type, gint default_value, GParamFlags flags);
Creates a new GParamSpecEnum instance specifying a G_TYPE_ENUM
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
enum_type : |
a GType derived from G_TYPE_ENUM
|
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_enum (GValue *value, gint v_enum);
Sets the contents of a G_TYPE_ENUM
GValue
to v_enum.
.
value : |
a valid GValue whose type is derived from G_TYPE_ENUM
|
v_enum : |
enum value to be set |
gint g_value_get_enum (const GValue *value);
Gets the contents of a G_TYPE_ENUM
GValue.
value : |
a valid GValue whose type is derived from G_TYPE_ENUM
|
Returns : | enum contents of value
|
#define G_IS_PARAM_SPEC_FLAGS(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLAGS))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_FLAGS
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_FLAGS(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLAGS, GParamSpecFlags))
Casts a GParamSpec instance into a GParamSpecFlags.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_FLAGS(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLAGS))
Returns whether the given GValue can hold values derived from type G_TYPE_FLAGS
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_FLAGS (g_param_spec_types[11])
The GType of GParamSpecFlags.
typedef struct {
GParamSpec parent_instance;
GFlagsClass *flags_class;
guint default_value;
} GParamSpecFlags;
A GParamSpec derived structure that contains the meta data for flags properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GFlagsClass *flags_class ; |
the GFlagsClass for the flags |
guint default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_flags (const gchar *name, const gchar *nick, const gchar *blurb, GType flags_type, guint default_value, GParamFlags flags);
Creates a new GParamSpecEnum instance specifying a G_TYPE_FLAGS
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
flags_type : |
a GType derived from G_TYPE_FLAGS
|
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_flags (GValue *value, guint v_flags);
Sets the contents of a G_TYPE_FLAGS
GValue
to v_flags
.
value : |
a valid GValue whose type is derived from G_TYPE_FLAGS
|
v_flags : |
flags value to be set |
guint g_value_get_flags (const GValue *value);
Gets the contents of a G_TYPE_FLAGS
GValue.
value : |
a valid GValue whose type is derived from G_TYPE_FLAGS
|
Returns : | flags contents of value
|
#define G_IS_PARAM_SPEC_STRING(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_STRING))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_STRING
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_STRING(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_STRING, GParamSpecString))
Casts a GParamSpec instance into a GParamSpecString.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_STRING(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_STRING))
Returns whether the given GValue can hold values of type G_TYPE_STRING
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_STRING (g_param_spec_types[14])
The GType of GParamSpecString.
typedef struct {
GParamSpec parent_instance;
gchar *default_value;
gchar *cset_first;
gchar *cset_nth;
gchar substitutor;
guint null_fold_if_empty : 1;
guint ensure_non_null : 1;
} GParamSpecString;
A GParamSpec derived structure that contains the meta data for string properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gchar *default_value ; |
default value for the property specified |
gchar *cset_first ; |
a string containing the allowed values for the first byte |
gchar *cset_nth ; |
a string containing the allowed values for the subsequent bytes |
gchar substitutor ; |
the replacement byte for bytes which don't match cset_first or cset_nth .
|
guint null_fold_if_empty : 1; |
replace empty string by NULL
|
guint ensure_non_null : 1; |
replace NULL strings by an empty string
|
GParamSpec* g_param_spec_string (const gchar *name, const gchar *nick, const gchar *blurb, const gchar *default_value, GParamFlags flags);
Creates a new GParamSpecString instance.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_string (GValue *value, const gchar *v_string);
Sets the contents of a G_TYPE_STRING
GValue
to v_string
.
value : |
a valid GValue of type G_TYPE_STRING
|
v_string : |
string to be set |
void g_value_set_static_string (GValue *value, const gchar *v_string);
Sets the contents of a G_TYPE_STRING
GValue
to v_string
. The string is assumed to be
static, and is thus not duplicated when setting the GValue.
value : |
a valid GValue of type G_TYPE_STRING
|
v_string : |
static string to be set |
void g_value_take_string (GValue *value, gchar *v_string);
Sets the contents of a G_TYPE_STRING
GValue
to v_string
.
value : |
a valid GValue of type G_TYPE_STRING
|
v_string : |
duplicated unowned string to be set |
void g_value_set_string_take_ownership (GValue *value, gchar *v_string);
g_value_set_string_take_ownership
is deprecated
and should not be used in newly-written code. Use g_value_take_string()
instead.
This is an internal function introduced mainly for C marshallers.
value : |
a valid GValue of type G_TYPE_STRING
|
v_string : |
duplicated unowned string to be set |
const gchar* g_value_get_string (const GValue *value);
Gets the contents of a G_TYPE_STRING
GValue.
value : |
a valid GValue of type G_TYPE_STRING
|
Returns : | string content of value
|
gchar* g_value_dup_string (const GValue *value);
Gets a copy the contents of a G_TYPE_STRING
GValue.
value : |
a valid GValue of type G_TYPE_STRING
|
Returns : | a newly allocated copy of the string content of value
|
#define G_IS_PARAM_SPEC_PARAM(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_PARAM))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_PARAM
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_PARAM(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_PARAM, GParamSpecParam))
Casts a GParamSpec instance into a GParamSpecParam.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_PARAM(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_PARAM))
Returns whether the given GValue can hold values derived from type G_TYPE_PARAM
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_PARAM (g_param_spec_types[15])
The GType of GParamSpecParam.
typedef struct {
GParamSpec parent_instance;
} GParamSpecParam;
A GParamSpec
derived structure that contains the meta data for
G_TYPE_PARAM
properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GParamSpec* g_param_spec_param (const gchar *name, const gchar *nick, const gchar *blurb, GType param_type, GParamFlags flags);
Creates a new GParamSpecParam instance specifying a G_TYPE_PARAM
property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
param_type : |
a GType derived from G_TYPE_PARAM
|
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_param (GValue *value, GParamSpec *param);
Sets the contents of a G_TYPE_PARAM
GValue
to param
.
value : |
a valid GValue of type G_TYPE_PARAM
|
param : |
the GParamSpec to be set |
void g_value_take_param (GValue *value, GParamSpec *param);
Sets the contents of a G_TYPE_PARAM
GValue
to param
and takes over the ownership of
the callers reference to param
; the caller doesn't have to unref it
any more.
value : |
a valid GValue of type G_TYPE_PARAM
|
param : |
the GParamSpec to be set |
void g_value_set_param_take_ownership (GValue *value, GParamSpec *param);
g_value_set_param_take_ownership
is deprecated
and should not be used in newly-written code. Use g_value_take_param()
instead.
This is an internal function introduced mainly for C marshallers.
value : |
a valid GValue of type G_TYPE_PARAM
|
param : |
the GParamSpec to be set |
GParamSpec* g_value_get_param (const GValue *value);
Gets the contents of a G_TYPE_PARAM
GValue.
value : |
a valid GValue whose type is derived from G_TYPE_PARAM
|
Returns : | GParamSpec
content of value
|
GParamSpec* g_value_dup_param (const GValue *value);
Gets the contents of a G_TYPE_PARAM
GValue,
increasing its reference count.
value : |
a valid GValue whose type is derived from G_TYPE_PARAM
|
Returns : | GParamSpec
content of value , should be
unreferenced when no longer needed.
|
#define G_IS_PARAM_SPEC_BOXED(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOXED))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_BOXED
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_BOXED(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOXED, GParamSpecBoxed))
Casts a GParamSpec instance into a GParamSpecBoxed.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_BOXED(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOXED))
Returns whether the given GValue can hold values derived from type G_TYPE_BOXED
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_BOXED (g_param_spec_types[16])
The GType of GParamSpecBoxed.
typedef struct {
GParamSpec parent_instance;
} GParamSpecBoxed;
A GParamSpec derived structure that contains the meta data for boxed properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GParamSpec* g_param_spec_boxed (const gchar *name, const gchar *nick, const gchar *blurb, GType boxed_type, GParamFlags flags);
Creates a new GParamSpecBoxed instance specifying a G_TYPE_BOXED
derived property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
boxed_type : |
G_TYPE_BOXED derived type of this
property
|
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_boxed (GValue *value, gconstpointer v_boxed);
Sets the contents of a G_TYPE_BOXED
derived GValue
to v_boxed
.
value : |
a valid GValue of G_TYPE_BOXED
derived type
|
v_boxed : |
boxed value to be set |
void g_value_set_static_boxed (GValue *value, gconstpointer v_boxed);
Sets the contents of a G_TYPE_BOXED
derived GValue
to v_boxed
. The boxed value is assumed
to be static, and is thus not duplicated when setting the GValue.
value : |
a valid GValue of G_TYPE_BOXED
derived type
|
v_boxed : |
static boxed value to be set |
void g_value_take_boxed (GValue *value, gconstpointer v_boxed);
Sets the contents of a G_TYPE_BOXED
derived GValue
to v_boxed
and takes over the ownership
of the callers reference to v_boxed
; the caller doesn't have to unref
it any more.
value : |
a valid GValue of G_TYPE_BOXED
derived type
|
v_boxed : |
duplicated unowned boxed value to be set |
void g_value_set_boxed_take_ownership (GValue *value, gconstpointer v_boxed);
g_value_set_boxed_take_ownership
is deprecated
and should not be used in newly-written code. Use g_value_take_boxed()
instead.
This is an internal function introduced mainly for C marshallers.
value : |
a valid GValue of G_TYPE_BOXED
derived type
|
v_boxed : |
duplicated unowned boxed value to be set |
gpointer g_value_get_boxed (const GValue *value);
Gets the contents of a G_TYPE_BOXED
derived GValue.
value : |
a valid GValue of G_TYPE_BOXED
derived type
|
Returns : | boxed contents of value
|
gpointer g_value_dup_boxed (const GValue *value);
Gets the contents of a G_TYPE_BOXED
derived GValue.
Upon getting, the boxed value is duplicated and needs to be later freed with g_boxed_free()
, e.g. like: g_boxed_free
(G_VALUE_TYPE (value
), return_value);
value : |
a valid GValue of G_TYPE_BOXED
derived type
|
Returns : | boxed contents of value
|
#define G_IS_PARAM_SPEC_POINTER(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_POINTER))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_POINTER
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_POINTER(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_POINTER, GParamSpecPointer))
Casts a GParamSpec instance into a GParamSpecPointer.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_POINTER(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_POINTER))
Returns whether the given GValue can hold values of type G_TYPE_POINTER
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_POINTER (g_param_spec_types[17])
The GType of GParamSpecPointer.
typedef struct {
GParamSpec parent_instance;
} GParamSpecPointer;
A GParamSpec derived structure that contains the meta data for pointer properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GParamSpec* g_param_spec_pointer (const gchar *name, const gchar *nick, const gchar *blurb, GParamFlags flags);
Creates a new GParamSpecPoiner instance specifying a
pointer property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_pointer (GValue *value, gpointer v_pointer);
Sets the contents of a pointer GValue
to v_pointer
.
value : |
a valid GValue of G_TYPE_POINTER
|
v_pointer : |
pointer value to be set |
gpointer g_value_get_pointer (const GValue *value);
Gets the contents of a pointer GValue.
value : |
a valid GValue of G_TYPE_POINTER
|
Returns : | pointer contents of value
|
#define G_IS_PARAM_SPEC_OBJECT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OBJECT))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_OBJECT
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_OBJECT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OBJECT, GParamSpecObject))
Casts a GParamSpec instance into a GParamSpecObject.
pspec : |
a valid GParamSpec instance |
#define G_VALUE_HOLDS_OBJECT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_OBJECT))
Returns whether the given GValue can hold values derived from type G_TYPE_OBJECT
.
value : |
a valid GValue structure |
#define G_TYPE_PARAM_OBJECT (g_param_spec_types[19])
The GType of GParamSpecObject.
typedef struct {
GParamSpec parent_instance;
} GParamSpecObject;
A GParamSpec derived structure that contains the meta data for object properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GParamSpec* g_param_spec_object (const gchar *name, const gchar *nick, const gchar *blurb, GType object_type, GParamFlags flags);
Creates a new GParamSpecBoxed instance specifying a G_TYPE_OBJECT
derived property.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
object_type : |
G_TYPE_OBJECT derived type of this
property
|
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
void g_value_set_object (GValue *value, gpointer v_object);
Sets the contents of a G_TYPE_OBJECT
derived GValue
to v_object
.
value : |
a valid GValue of G_TYPE_OBJECT
derived type
|
v_object : |
object value to be set |
void g_value_take_object (GValue *value, gpointer v_object);
Sets the contents of a G_TYPE_OBJECT
derived GValue
to v_object
and takes over the ownership
of the callers reference to v_object
;
the caller doesn't have to unref it any more.
value : |
a valid GValue of G_TYPE_OBJECT
derived type
|
v_object : |
object value to be set |
void g_value_set_object_take_ownership (GValue *value, gpointer v_object);
g_value_set_object_take_ownership
is deprecated
and should not be used in newly-written code. Use g_value_take_object()
instead.
This is an internal function introduced mainly for C marshallers.
value : |
a valid GValue of G_TYPE_OBJECT
derived type
|
v_object : |
object value to be set |
gpointer g_value_get_object (const GValue *value);
Gets the contents of a G_TYPE_OBJECT
derived GValue.
value : |
a valid GValue of G_TYPE_OBJECT
derived type
|
Returns : | object contents of value
|
GObject* g_value_dup_object (const GValue *value);
Gets the contents of a G_TYPE_OBJECT
derived GValue,
increasing its reference count.
value : |
a valid GValue whose type is derived from G_TYPE_OBJECT
|
Returns : | object content of value ,
should be unreferenced when no longer needed.
|
#define G_IS_PARAM_SPEC_UNICHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UNICHAR))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_UNICHAR
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_UNICHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UNICHAR, GParamSpecUnichar))
Casts a GParamSpec instance into a GParamSpecUnichar.
pspec : |
a valid GParamSpec instance |
#define G_TYPE_PARAM_UNICHAR (g_param_spec_types[9])
The GType of GParamSpecUnichar.
typedef struct {
GParamSpec parent_instance;
gunichar default_value;
} GParamSpecUnichar;
A GParamSpec derived structure that contains the meta data for unichar (unsigned integer) properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
gunichar default_value ; |
default value for the property specified |
GParamSpec* g_param_spec_unichar (const gchar *name, const gchar *nick, const gchar *blurb, gunichar default_value, GParamFlags flags);
Creates a new GParamSpecUnichar instance specifying a G_TYPE_UINT
property. GValue
structures for this property can be accessed with g_value_set_uint()
and g_value_get_uint()
.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
default_value : |
default value for the property specified |
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
#define G_IS_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_VALUE_ARRAY))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_VALUE_ARRAY
.
pspec : |
a valid GParamSpec instance |
#define G_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_VALUE_ARRAY, GParamSpecValueArray))
Casts a GParamSpec instance into a GParamSpecValueArray.
pspec : |
a valid GParamSpec instance |
#define G_TYPE_PARAM_VALUE_ARRAY (g_param_spec_types[18])
The GType of GParamSpecValueArray.
typedef struct {
GParamSpec parent_instance;
GParamSpec *element_spec;
guint fixed_n_elements;
} GParamSpecValueArray;
A GParamSpec derived structure that contains the meta data for GValueArray properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GParamSpec *element_spec ; |
a GParamSpec describing the elements contained in arrays
of this property, may be NULL
|
guint fixed_n_elements ; |
if greater than 0, arrays of this property will always have this many elements |
GParamSpec* g_param_spec_value_array (const gchar *name, const gchar *nick, const gchar *blurb, GParamSpec *element_spec, GParamFlags flags);
Creates a new GParamSpecValueArray instance specifying a G_TYPE_VALUE_ARRAY
property. G_TYPE_VALUE_ARRAY
is a
G_TYPE_BOXED
type, as such, GValue structures for this property can be accessed
with g_value_set_boxed()
and g_value_get_boxed()
.
See g_param_spec_internal()
for details on property
names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
element_spec : |
a GParamSpec describing the elements contained in arrays
of this property, may be NULL
|
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
#define G_IS_PARAM_SPEC_OVERRIDE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OVERRIDE))
Returns whether the given GParamSpec is of type
G_TYPE_PARAM_OBJECT
.
pspec : |
a GParamSpec |
#define G_PARAM_SPEC_OVERRIDE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OVERRIDE, GParamSpecOverride))
Casts a GParamSpec into a GParamSpecObject.
pspec : |
a GParamSpec |
#define G_TYPE_PARAM_OVERRIDE (g_param_spec_types[20])
The GType of GParamSpecOverride.
typedef struct {
} GParamSpecOverride;
This is a type of GParamSpec type that simply redirects operations to
another paramspec. All operations other than getting or setting the value are
redirected, including accessing the nick and blurb, validating a value, and so
forth. See
g_param_spec_get_redirect_target()
for retrieving
the overidden property. GParamSpecOverride is used in implementing
g_object_class_override_property()
, and will not be
directly useful unless a new base class type similar to CObject is implemented.
GParamSpec* g_param_spec_override (const gchar *name, GParamSpec *overridden);
Creates a new property of type GParamSpecOverride. This is used to direct operations to another paramspec, and will not be directly useful unless a new base class type similar to CObject is implemented.
name : |
the name of the property. |
overridden : |
The property that is being overridden |
Returns : | the newly created GParamSpec |
#define G_IS_PARAM_SPEC_GTYPE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_GTYPE))
Returns whether the given
GParamSpec is of type
G_TYPE_PARAM_GTYPE
.
pspec : |
a GParamSpec |
#define G_PARAM_SPEC_GTYPE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_GTYPE, GParamSpecGType))
Casts a GParamSpec into a GParamSpecGType.
pspec : |
a GParamSpec |
#define G_TYPE_PARAM_GTYPE (g_param_spec_types[21])
The GType of GParamSpecGType.
typedef struct { GParamSpec parent_instance; GType is_a_type; } GParamSpecGType;
A GParamSpec derived structure that contains the meta data for GType properties.
GParamSpec parent_instance ; |
private GParamSpec portion |
GType is_a_type ; |
a GType whose subtypes can occur as values |
GParamSpec* g_param_spec_gtype (const gchar *name, const gchar *nick, const gchar *blurb, GType is_a_type, GParamFlags flags);
Creates a new GParamSpecGType
instance specifying a
G_TYPE_GTYPE
property.
See
g_param_spec_internal()
for details on property names.
name : |
canonical name of the property specified |
nick : |
nick name for the property specified |
blurb : |
description of the property specified |
is_a_type : |
a GType
whose subtypes are allowed as values of the property (use
G_TYPE_NONE
for any type)
|
flags : |
flags for the property specified |
Returns : | a newly created parameter specification |
GParamSpec,
GValue,
g_object_class_install_property()
.
For additional information or queries on this
page send
feedback
© 2005-2007 Nokia |