Method

GObjectObjectget_property

Declaration

void
g_object_get_property (
  GObject* object,
  const gchar* property_name,
  GValue* value
)

Description

Gets a property of an object.

The value can be:

  • an empty GValue initialized by G_VALUE_INIT, which will be automatically initialized with the expected type of the property (since GLib 2.60)
  • a GValue initialized with the expected type of the property
  • a GValue initialized with a type to which the expected type of the property can be transformed

In general, a copy is made of the property contents and the caller is responsible for freeing the memory by calling g_value_unset().

Note that g_object_get_property() is really intended for language bindings, g_object_get() is much more convenient for C programming.

Parameters

property_name const gchar*
 

The name of the property to get.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
value GValue
 

Return location for the property value.

 The data is owned by the caller of the function.