The Glib Object system v0.10.0

Mathieu Lacage

            <>
          

Copyright © 2002, 2003, 2004 Mathieu Lacage

This article is copyrighted to Mathieu Lacage. Although copying and/or reuse of this document is allowed per the license described below, it would be considered friendly to link to this document rather than make a copy of it and to notify me in case you want to republish this work in paper.

This work may be reproduced and distributed in whole or in part, in any medium, physical or electronic, so as long as this copyright notice remains intact and unchanged on all copies. Commercial redistribution is permitted and encouraged, but you may not redistribute, in whole or in part, under terms more restrictive than those under which you received it. If you redistribute a modified or translated version of this work, you must also make the source code to the modified or translated version available in electronic form without charge. However, mere aggregation as part of a larger work shall not count as a modification for this purpose.

All code examples in this work are placed into the public domain, and may be used, modified and redistributed without restriction.

BECAUSE THIS WORK IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE WORK, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE WORK "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. SHOULD THE WORK PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE WORK AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE WORK, EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

If you want to help on this document, feel free to send me a patch to the original xml which is available on .

While I am always happy to answer questions about this document, I am not always the best person these questions should be asked to. In doubt, always mail [e-mail]. You can register to this mailing list on .

I'd like to thank Owen Taylor, Tim Janik and especially James Henstridge for their help on IRC, when I was trying to figure out the why of some of GObject aspects.

Revision History
Revision 0.10.0	24 September 2004
Added contributed by Ali Zeeshan () Add note about g_type_class_add_private and chain up the sample finalize and dispose handlers, contributed by Sylvain FORET (). The following changes have been contributed by Stefan Kost () Extended by mentioning predefined marshallers Added some notes regarding to the naming priv and klass Changed default: of property switch() statements to use G_OBJECT_WARN_INVALID_PROPERTY_ID(object,property_id,pspec); Extended Added Added link for c++ tutorial and pimpl idom Changed PREFIX_OBJECT_CHECK_TYPE into PREFIX_TYPE_CHECK_INSTANCE_TYPE
Revision 0.9.0	22 June 2004
Mostly maintainance contributed by Stefan Kost () Modify the GType section on instantiable types to make the comparison with C++ idioms more accurate (me). Inspired by questions from () Added section about chaining up and remove simple chainup comment (me). Based on an idea and patch by () Several minor clarification () Link to GLib docs regarding to how to disable dynamic type checks () Fixing a few typos () Fixing expressions b->parent.parent.g_class->g_type, ((GTypeInstance*)b)->g_class->g_type as pointed out by Stepan Kasal () Changed PREFIX_OBJECT_TYPE -> PREFIX_TYPE_OBJECT as suggested by Tommi Komulainen ()
Revision 0.8.0	20 September 2003
Add support for pdf build with Fop thanks to Lorenzo Gil Sanchez Remove stupid old tags from the source xml to make it docbook-compliant. Fix dia testing in the makefiles Fix sample code in GObject section, thanks to comments from Marek Peteraj and Christophe Fergeau Make the sample code in sample/gobject better.
Revision 0.7.0	25 July 2003
Rephrase a few bits in GSignal sections. Add discussion of the detail parameter to the GSignal sections per suggestion from paolo borelli ().
Revision 0.6.0	24 July 2003
Fix a major bug in GSignal documentation Fix a few bugs in GObject sample code Remove signal section from Howto GObject section. Rewrite a new standalone signal section and its accompanying sample code.
Revision 0.5.0	18 July 2003
Improve interface sample code: make the instance parameter explicit. Misc fixes/typos from Manuel Zabelt () Spelling fixes from Jean-Yves Lefort ()) Add introduction chapter per suggestion from David Turner (). Move the first section in GType chapter to intoduction chapter as footnote. Add section on interface prerequisites as suggsted by Matthias Clasen ()
Revision 0.4.0	17 March 2003
Spelling fixes and misc comments from Jery Kakol (). Spelling fixes from Steven Cole (). Typo fixes in GType, fix sample code. Add sample code. Fill Section on Howto define an interface. Fill Section on Howto implement an interface.
Revision 0.3.0	22 February 2003
Fill Section on Howto implement a GObject. Misc fixes in GType and GSignal chapters.
Revision 0.2.0	cannot remember
Second draft
Revision 0.1.0	cannot remember
First draft

---

Table of Contents