gobject.h File Reference

API published in:
API deprecated in:


#include <_ansi.h>
#include <gobject/gtype.h>
#include <gobject/gvalue.h>
#include <gobject/gparam.h>
#include <gobject/gclosure.h>
#include <gobject/gsignal.h>

Go to the source code of this file.


Data Structures

struct   _GObject
struct   _GObjectClass
struct   _GObjectConstructParam

Defines

#define  G_TYPE_IS_OBJECT(type)   (G_TYPE_FUNDAMENTAL (type) == G_TYPE_OBJECT)
#define  G_OBJECT(object)   (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_OBJECT, GObject))
#define  G_OBJECT_CLASS(class)   (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_OBJECT, GObjectClass))
#define  G_IS_OBJECT(object)   (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_OBJECT))
#define  G_IS_OBJECT_CLASS(class)   (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_OBJECT))
#define  G_OBJECT_GET_CLASS(object)   (G_TYPE_INSTANCE_GET_CLASS ((object), G_TYPE_OBJECT, GObjectClass))
#define  G_OBJECT_TYPE(object)   (G_TYPE_FROM_INSTANCE (object))
#define  G_OBJECT_TYPE_NAME(object)   (g_type_name (G_OBJECT_TYPE (object)))
#define  G_OBJECT_CLASS_TYPE(class)   (G_TYPE_FROM_CLASS (class))
#define  G_OBJECT_CLASS_NAME(class)   (g_type_name (G_OBJECT_CLASS_TYPE (class)))
#define  G_VALUE_HOLDS_OBJECT(value)   (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_OBJECT))
#define  G_TYPE_INITIALLY_UNOWNED   (g_initially_unowned_get_type())
#define  G_INITIALLY_UNOWNED(object)   (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnowned))
#define  G_INITIALLY_UNOWNED_CLASS(class)   (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass))
#define  G_IS_INITIALLY_UNOWNED(object)   (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_INITIALLY_UNOWNED))
#define  G_IS_INITIALLY_UNOWNED_CLASS(class)   (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_INITIALLY_UNOWNED))
#define  G_INITIALLY_UNOWNED_GET_CLASS(object)   (G_TYPE_INSTANCE_GET_CLASS ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass))
#define  G_OBJECT_WARN_INVALID_PSPEC(object, pname, property_id, pspec)
#define  G_OBJECT_WARN_INVALID_PROPERTY_ID(object, property_id, pspec)   G_OBJECT_WARN_INVALID_PSPEC ((object), "property", (property_id), (pspec))

Typedefs

typedef _GObject  GObject
typedef _GObjectClass  GObjectClass
typedef _GObject  GInitiallyUnowned
typedef _GObjectClass  GInitiallyUnownedClass
typedef _GObjectConstructParam  GObjectConstructParam
typedef void(*  GObjectGetPropertyFunc )(GObject *object, guint property_id, GValue *value, GParamSpec *pspec)
typedef void(*  GObjectSetPropertyFunc )(GObject *object, guint property_id, const GValue *value, GParamSpec *pspec)
typedef void(*  GObjectFinalizeFunc )(GObject *object)
typedef void(*  GWeakNotify )(gpointer data, GObject *where_the_object_was)
typedef void(*  GToggleNotify )(gpointer data, GObject *object, gboolean is_last_ref)

Functions

IMPORT_C GType  g_initially_unowned_get_type (void)
IMPORT_C void  g_object_class_install_property (GObjectClass *oclass, guint property_id, GParamSpec *pspec)
IMPORT_C GParamSpec g_object_class_find_property (GObjectClass *oclass, const gchar *property_name)
IMPORT_C GParamSpec **  g_object_class_list_properties (GObjectClass *oclass, guint *n_properties)
IMPORT_C void  g_object_class_override_property (GObjectClass *oclass, guint property_id, const gchar *name)
IMPORT_C void  g_object_interface_install_property (gpointer g_iface, GParamSpec *pspec)
IMPORT_C GParamSpec g_object_interface_find_property (gpointer g_iface, const gchar *property_name)
IMPORT_C GParamSpec **  g_object_interface_list_properties (gpointer g_iface, guint *n_properties_p)
IMPORT_C gpointer  g_object_new (GType object_type, const gchar *first_property_name,...)
IMPORT_C gpointer  g_object_newv (GType object_type, guint n_parameters, GParameter *parameters)
IMPORT_C GObject g_object_new_valist (GType object_type, const gchar *first_property_name, va_list var_args)
IMPORT_C void  g_object_set (gpointer object, const gchar *first_property_name,...) G_GNUC_NULL_TERMINATED
IMPORT_C void  g_object_get (gpointer object, const gchar *first_property_name,...) G_GNUC_NULL_TERMINATED
IMPORT_C gpointer  g_object_connect (gpointer object, const gchar *signal_spec,...) G_GNUC_NULL_TERMINATED
IMPORT_C void  g_object_disconnect (gpointer object, const gchar *signal_spec,...) G_GNUC_NULL_TERMINATED
IMPORT_C void  g_object_set_valist (GObject *object, const gchar *first_property_name, va_list var_args)
IMPORT_C void  g_object_get_valist (GObject *object, const gchar *first_property_name, va_list var_args)
IMPORT_C void  g_object_set_property (GObject *object, const gchar *property_name, const GValue *value)
IMPORT_C void  g_object_get_property (GObject *object, const gchar *property_name, GValue *value)
IMPORT_C void  g_object_freeze_notify (GObject *object)
IMPORT_C void  g_object_notify (GObject *object, const gchar *property_name)
IMPORT_C void  g_object_thaw_notify (GObject *object)
IMPORT_C gboolean  g_object_is_floating (gpointer object)
IMPORT_C gpointer  g_object_ref_sink (gpointer object)
IMPORT_C gpointer  g_object_ref (gpointer object)
IMPORT_C void  g_object_unref (gpointer object)
IMPORT_C void  g_object_weak_ref (GObject *object, GWeakNotify notify, gpointer data)
IMPORT_C void  g_object_weak_unref (GObject *object, GWeakNotify notify, gpointer data)
IMPORT_C void  g_object_add_weak_pointer (GObject *object, gpointer *weak_pointer_location)
IMPORT_C void  g_object_remove_weak_pointer (GObject *object, gpointer *weak_pointer_location)
IMPORT_C void  g_object_add_toggle_ref (GObject *object, GToggleNotify notify, gpointer data)
IMPORT_C void  g_object_remove_toggle_ref (GObject *object, GToggleNotify notify, gpointer data)
IMPORT_C gpointer  g_object_get_qdata (GObject *object, GQuark quark)
IMPORT_C void  g_object_set_qdata (GObject *object, GQuark quark, gpointer data)
IMPORT_C void  g_object_set_qdata_full (GObject *object, GQuark quark, gpointer data, GDestroyNotify destroy)
IMPORT_C gpointer  g_object_steal_qdata (GObject *object, GQuark quark)
IMPORT_C gpointer  g_object_get_data (GObject *object, const gchar *key)
IMPORT_C void  g_object_set_data (GObject *object, const gchar *key, gpointer data)
IMPORT_C void  g_object_set_data_full (GObject *object, const gchar *key, gpointer data, GDestroyNotify destroy)
IMPORT_C gpointer  g_object_steal_data (GObject *object, const gchar *key)
IMPORT_C void  g_object_watch_closure (GObject *object, GClosure *closure)
IMPORT_C GClosure g_cclosure_new_object (GCallback callback_func, GObject *object)
IMPORT_C GClosure g_cclosure_new_object_swap (GCallback callback_func, GObject *object)
IMPORT_C GClosure g_closure_new_object (guint sizeof_closure, GObject *object)
IMPORT_C void  g_value_set_object (GValue *value, gpointer v_object)
IMPORT_C gpointer  g_value_get_object (const GValue *value)
IMPORT_C GObject g_value_dup_object (const GValue *value)
IMPORT_C gulong  g_signal_connect_object (gpointer instance, const gchar *detailed_signal, GCallback c_handler, gpointer gobject, GConnectFlags connect_flags)
IMPORT_C void  g_object_force_floating (GObject *object)
IMPORT_C void  g_object_run_dispose (GObject *object)
IMPORT_C void  g_value_take_object (GValue *value, gpointer v_object)
IMPORT_C void  g_value_set_object_take_ownership (GValue *value, gpointer v_object)
gsize  g_object_compat_control (gsize what, gpointer data)

Define Documentation

#define G_INITIALLY_UNOWNED object   )     (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnowned))
 
#define G_INITIALLY_UNOWNED_CLASS class   )     (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass))
 
#define G_INITIALLY_UNOWNED_GET_CLASS object   )     (G_TYPE_INSTANCE_GET_CLASS ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass))
 
#define G_IS_INITIALLY_UNOWNED object   )     (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_INITIALLY_UNOWNED))
 
#define G_IS_INITIALLY_UNOWNED_CLASS class   )     (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_INITIALLY_UNOWNED))
 
#define G_IS_OBJECT object   )     (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_OBJECT))
 
#define G_IS_OBJECT_CLASS class   )     (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_OBJECT))
 
#define G_OBJECT object   )     (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_OBJECT, GObject))
 
#define G_OBJECT_CLASS class   )     (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_OBJECT, GObjectClass))
 
#define G_OBJECT_CLASS_NAME class   )     (g_type_name (G_OBJECT_CLASS_TYPE (class)))
 
#define G_OBJECT_CLASS_TYPE class   )     (G_TYPE_FROM_CLASS (class))
 
#define G_OBJECT_GET_CLASS object   )     (G_TYPE_INSTANCE_GET_CLASS ((object), G_TYPE_OBJECT, GObjectClass))
 
#define G_OBJECT_TYPE object   )     (G_TYPE_FROM_INSTANCE (object))
 
#define G_OBJECT_TYPE_NAME object   )     (g_type_name (G_OBJECT_TYPE (object)))
 
#define G_OBJECT_WARN_INVALID_PROPERTY_ID object,
property_id,
pspec   )     G_OBJECT_WARN_INVALID_PSPEC ((object), "property", (property_id), (pspec))
 
#define G_OBJECT_WARN_INVALID_PSPEC object,
pname,
property_id,
pspec   ) 
 

Value:

G_STMT_START { \
  GObject *_object = (GObject*) (object); \
  GParamSpec *_pspec = (GParamSpec*) (pspec); \
  guint _property_id = (property_id); \
  g_warning ("%s: invalid %s id %u for \"%s\" of type `%s' in `%s'", \
             G_STRLOC, \
             (pname), \
             _property_id, \
             _pspec->name, \
             g_type_name (G_PARAM_SPEC_TYPE (_pspec)), \
             G_OBJECT_TYPE_NAME (_object)); \
} G_STMT_END
#define G_TYPE_INITIALLY_UNOWNED   (g_initially_unowned_get_type())
 
#define G_TYPE_IS_OBJECT type   )     (G_TYPE_FUNDAMENTAL (type) == G_TYPE_OBJECT)
 
#define G_VALUE_HOLDS_OBJECT value   )     (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_OBJECT))
 

Typedef Documentation

typedef struct _GObject GInitiallyUnowned
 
typedef struct _GObjectClass GInitiallyUnownedClass
 
typedef struct _GObject GObject
 
typedef struct _GObjectClass GObjectClass
 
typedef struct _GObjectConstructParam GObjectConstructParam
 
typedef void(* GObjectFinalizeFunc)(GObject *object)
 
typedef void(* GObjectGetPropertyFunc)(GObject *object, guint property_id, GValue *value, GParamSpec *pspec)
 
typedef void(* GObjectSetPropertyFunc)(GObject *object, guint property_id, const GValue *value, GParamSpec *pspec)
 
typedef void(* GToggleNotify)(gpointer data, GObject *object, gboolean is_last_ref)
 
typedef void(* GWeakNotify)(gpointer data, GObject *where_the_object_was)
 

Function Documentation

IMPORT_C GClosure* g_cclosure_new_object GCallback  callback_func,
GObject object
 
IMPORT_C GClosure* g_cclosure_new_object_swap GCallback  callback_func,
GObject object
 
IMPORT_C GClosure* g_closure_new_object guint  sizeof_closure,
GObject object
 
IMPORT_C GType g_initially_unowned_get_type void   ) 
 
IMPORT_C void g_object_add_toggle_ref GObject object,
GToggleNotify  notify,
gpointer  data
 
IMPORT_C void g_object_add_weak_pointer GObject object,
gpointer weak_pointer_location
 
IMPORT_C GParamSpec* g_object_class_find_property GObjectClass oclass,
const gchar property_name
 
IMPORT_C void g_object_class_install_property GObjectClass oclass,
guint  property_id,
GParamSpec pspec
 
IMPORT_C GParamSpec** g_object_class_list_properties GObjectClass oclass,
guint n_properties
 
IMPORT_C void g_object_class_override_property GObjectClass oclass,
guint  property_id,
const gchar name
 
gsize g_object_compat_control gsize  what,
gpointer  data
 
IMPORT_C gpointer g_object_connect gpointer  object,
const gchar signal_spec,
  ...
 
IMPORT_C void g_object_disconnect gpointer  object,
const gchar signal_spec,
  ...
 
IMPORT_C void g_object_force_floating GObject object  ) 
 
IMPORT_C void g_object_freeze_notify GObject object  ) 
 
IMPORT_C void g_object_get gpointer  object,
const gchar first_property_name,
  ...
 
IMPORT_C gpointer g_object_get_data GObject object,
const gchar key
 
IMPORT_C void g_object_get_property GObject object,
const gchar property_name,
GValue value
 
IMPORT_C gpointer g_object_get_qdata GObject object,
GQuark  quark
 
IMPORT_C void g_object_get_valist GObject object,
const gchar first_property_name,
va_list  var_args
 
IMPORT_C GParamSpec* g_object_interface_find_property gpointer  g_iface,
const gchar property_name
 
IMPORT_C void g_object_interface_install_property gpointer  g_iface,
GParamSpec pspec
 
IMPORT_C GParamSpec** g_object_interface_list_properties gpointer  g_iface,
guint n_properties_p
 
IMPORT_C gboolean g_object_is_floating gpointer  object  ) 
 
IMPORT_C gpointer g_object_new GType  object_type,
const gchar first_property_name,
  ...
 
IMPORT_C GObject* g_object_new_valist GType  object_type,
const gchar first_property_name,
va_list  var_args
 
IMPORT_C gpointer g_object_newv GType  object_type,
guint  n_parameters,
GParameter parameters
 
IMPORT_C void g_object_notify GObject object,
const gchar property_name
 
IMPORT_C gpointer g_object_ref gpointer  object  ) 
 
IMPORT_C gpointer g_object_ref_sink gpointer  object  ) 
 
IMPORT_C void g_object_remove_toggle_ref GObject object,
GToggleNotify  notify,
gpointer  data
 
IMPORT_C void g_object_remove_weak_pointer GObject object,
gpointer weak_pointer_location
 
IMPORT_C void g_object_run_dispose GObject object  ) 
 
IMPORT_C void g_object_set gpointer  object,
const gchar first_property_name,
  ...
 
IMPORT_C void g_object_set_data GObject object,
const gchar key,
gpointer  data
 
IMPORT_C void g_object_set_data_full GObject object,
const gchar key,
gpointer  data,
GDestroyNotify  destroy
 
IMPORT_C void g_object_set_property GObject object,
const gchar property_name,
const GValue value
 
IMPORT_C void g_object_set_qdata GObject object,
GQuark  quark,
gpointer  data
 
IMPORT_C void g_object_set_qdata_full GObject object,
GQuark  quark,
gpointer  data,
GDestroyNotify  destroy
 
IMPORT_C void g_object_set_valist GObject object,
const gchar first_property_name,
va_list  var_args
 
IMPORT_C gpointer g_object_steal_data GObject object,
const gchar key
 
IMPORT_C gpointer g_object_steal_qdata GObject object,
GQuark  quark
 
IMPORT_C void g_object_thaw_notify GObject object  ) 
 
IMPORT_C void g_object_unref gpointer  object  ) 
 
IMPORT_C void g_object_watch_closure GObject object,
GClosure closure
 
IMPORT_C void g_object_weak_ref GObject object,
GWeakNotify  notify,
gpointer  data
 
IMPORT_C void g_object_weak_unref GObject object,
GWeakNotify  notify,
gpointer  data
 
IMPORT_C gulong g_signal_connect_object gpointer  instance,
const gchar detailed_signal,
GCallback  c_handler,
gpointer  gobject,
GConnectFlags  connect_flags
 
IMPORT_C GObject* g_value_dup_object const GValue value  ) 
 
IMPORT_C gpointer g_value_get_object const GValue value  ) 
 
IMPORT_C void g_value_set_object GValue value,
gpointer  v_object
 
IMPORT_C void g_value_set_object_take_ownership GValue value,
gpointer  v_object
 
IMPORT_C void g_value_take_object GValue value,
gpointer  v_object
 

Copyright © Nokia Corporation 2001-2008
Back to top