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))

(G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_OBJECT))

#define G_IS_OBJECT_CLASS

(

class

)

(G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_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

IMPORT_C void g_object_freeze_notify

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

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

IMPORT_C gpointer g_object_ref_sink

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

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

IMPORT_C void g_object_unref

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
	)