GObject Reference Manual

for GObject 2.70.0 The latest version of this documentation can be found on-line at https://developer.gnome.org/gobject/unstable/.

Introduction

I. Concepts

Data types and programming
Exporting a C API

The GLib Dynamic Type System

Copy functions

Conventions

Non-instantiatable non-classed fundamental types

Instantiatable classed types: objects

Initialization and Destruction

Non-instantiatable classed types: interfaces

Interface Initialization
Interface Destruction

The GObject base class

Object instantiation

Object memory management

Reference count
Weak References
Reference counts and cycles

Object properties

Accessing multiple properties at once

The GObject messaging system

C Closures
Non-C closures (for the fearless)

Signal registration
Signal connection
Signal emission
The detail argument

II. API Reference

Type Information — The GLib Runtime type identification and management system
GTypePlugin — An interface for dynamically loadable types
GTypeModule — Type loading modules
GObject — The base object type
Enumeration and Flag Types — Enumeration and flags types
Boxed Types — A mechanism to wrap opaque C structures registered by the type system
Generic values — A polymorphic type that can hold values of any other type
Parameters and Values — Standard Parameter and Value Types
GParamSpec — Metadata for parameter specifications
Varargs Value Collection — Converting varargs to generic values
Signals — A means for customization of object behaviour and a general purpose notification mechanism
Closures — Functions as first-class objects
Value arrays — A container structure to maintain an array of generic values
GBinding — Bind two object properties

III. Tools Reference

glib-mkenums — C language enum description generation utility
glib-genmarshal — C code marshaller generation utility for GLib closures
gobject-query — display a tree of types

IV. Tutorial

How to define and implement a new GObject

Boilerplate header code

Boilerplate code

Object construction

Object destruction

Object methods

Non-virtual public methods
Virtual public methods
Virtual private Methods

Chaining up

How to define and implement interfaces

Defining interfaces
Implementing interfaces
Interface definition prerequisites
Interface properties
Overriding interface methods

How to create and use signals

Simple use of signals

V. Related Tools

Vala
GObject builder
Graphical inspection of GObjects
Debugging reference count problems
Writing API docs

Index of deprecated symbols

Index of new symbols in 2.2

Index of new symbols in 2.4

Index of new symbols in 2.6

Index of new symbols in 2.8

Index of new symbols in 2.10

Index of new symbols in 2.12

Index of new symbols in 2.14

Index of new symbols in 2.18

Index of new symbols in 2.22

Index of new symbols in 2.24

Index of new symbols in 2.26

Index of new symbols in 2.28

Index of new symbols in 2.30

Index of new symbols in 2.32

Index of new symbols in 2.34

Index of new symbols in 2.36

Index of new symbols in 2.38

Index of new symbols in 2.40

Index of new symbols in 2.42

Index of new symbols in 2.44

Index of new symbols in 2.46

Index of new symbols in 2.54

Index of new symbols in 2.56

Index of new symbols in 2.62

Index of new symbols in 2.66

Index of new symbols in 2.68

Index of new symbols in 2.70

Annotation Glossary