构造函数

GObjectObjectnew_with_properties

自:2.54

声明 [src]

GObject*
g_object_new_with_properties (
  GType object_type,
  guint n_properties,
  const char** names,
  const GValue* values
)

描述 [src]

使用提供的数组创建GObject子类型的新的实例,并使用这些数组设置其属性。两个数组都必须恰好有n_properties个元素,名称和值通过索引相对应。

未明确指定且未明确指定的构造参数(参见G_PARAM_CONSTRUCTG_PARAM_CONSTRUCT_ONLY)将被设置为它们的默认值。

自:2.54

此构造函数不可直接由语言绑定使用。

参数

object_type

类型: GType

要实例化的对象类型。

n_properties

类型: guint

属性的数目。

names

类型: 一个char*数组

要设置的每个属性的名称。

数组的长度由n_properties参数指定。
数据由函数的调用者拥有。
每个元素都是一个以NUL结尾的UTF-8字符串。
values

类型: 一个GValue数组

要设置的每个属性的值。

数组的长度由n_properties参数指定。
数据由函数的调用者拥有。

返回值

类型: GObject

object_type的新实例。

函数的调用者接管数据所有权,并负责释放它。