除非您尝试处理一些非常低级的代码,否则您真正需要关心的仅有两个是 GValue 和 GParamType
我将从GParamType
GParamType
用于向 GObject 注册属性。比如说,我有一个名为 Person 的 GObject 子类,我希望它有两个属性:Name 和 Age。在class_init
函数中,我会像这样注册这些
{
GParamSpec *pspec;
. . .
pspec = g_param_spec_string ("name", "Name", "The name of the person", "", G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_property (object_class, PROP_NAME, pspec);
pspec = g_param_spec_int ("age", "Age", "The age of the person", 0, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_property (object_class, PROP_AGE, spec);
. . .
}
现在您可以调用g_object_get
这些g_object_set
属性,系统将知道如何处理它
char *name;
int age;
g_object_set (G_OBJECT (person), "name", "Steve", "age", 37, NULL);
g_object_get (G_OBJECT (person), "name", &name, "age", &age, NULL);
g_print ("%s is %d years old\n", name, age);
// And because the type system knows when a property is a string, it knows how to give
// you a copy of the string, so you need to free it once you've finished with it
g_free (name);
这里解释了各种参数:GParamSpec所有标准类型都有 GValue 类型:strings、bools、ints 等,而 GStreamer 等其他一些库将注册自己的自定义类型。
除了在 GObjectClass 上安装属性之外,您很少需要处理 GParamSpec。它们出现的两个主要场合是在 GObjectClass 的 set/get_property 方法和 GObject 通知信号中。在最后一种情况下,通过调用来检测哪个属性收到了通知信号很有用g_param_spec_get_name
,但实际上最好使用更具体的通知信号,如下所示:
g_signal_connect (person, "notify::name", G_CALLBACK (name_changed_cb), NULL);
g_signal_connect (person, "notify::age", G_CALLBACK (age_changed_cb), NULL);
而不是
g_signal_connect (person, "notify", G_CALLBACK (something_changed_cb), NULL);
有时您可能想要创建自己的结构并将其用于属性。例如,如果我有
struct _PersonDetails {
char *name;
int age;
}
而不是在 Person 对象上有两个属性,我想要一个称为“详细信息”的属性。GLib 类型系统不知道如何处理我的自定义struct _PersonDetails
,因此我需要为它创建一个装箱类型,以便它知道如何正确复制/释放在 Glib 内部传递的结构。这就是GValue
进来的地方。
GValue
用于包装不同类型的值,以便可以正确复制和释放它们(如果需要),并且可以使用通用函数。
例如,GObjectClass 方法 set_property 的原型为
void set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec)
这意味着可以传入任何可以由 GValue 表示的类型,并且不需要特定的函数,例如 set_int_property、set_string_property、set_bool_property。
g_object_set
这也意味着函数g_object_get
知道如何处理传入的参数,因为它知道属性“name”被注册为字符串类型,并且它具有复制/释放该字符串所需的功能。
更多关于 GValue 的信息可以在这里找到 -通用值
为了struct _PersonDetails
向 GLib 类型系统注册我们的自定义,我们将创建一个自定义 Boxed 类型,它告诉系统如何复制和释放它。详细信息在这里:盒装类型
G_DEFINE_BOXED_TYPE (PersonDetails, person_details,
person_details_copy,
person_details_free)
. . .
static gpointer
person_details_copy (gpointer data)
{
struct _PersonDetails *details = (struct _PersonDetails *)data;
struct _PersonDetails *copy = g_new (struct _PersonDetails, 1);
// We need to copy the string
copy->name = g_strdup (details->name);
copy->age = details->age;
return (gpointer) copy;
}
static void
person_details_free (gpointer data)
{
struct _PersonDetails *details = (struct _PersonDetails *)data;
// name was allocated so it needs freed as well
g_free (details->name);
g_free (details);
}
现在我们可以使用注册我们的类型
pspec = g_param_spec_boxed ("details", "Details", "The person's details", person_details_get_type (), G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_property (object_class, PROP_DETAILS, pspec);