NAME

Gimp::basewidget - pragma to declare the superclass of a gtk widget

SYNOPSIS

  use Gimp::basewidget 'superclass';

e.g.

  use Gimp::basewidget Gtk::Button;

DESCRIPTION

This pragma can (but does not need to) be used to declare the current package as a childclass of an existing Gtk widget class. The only ``import tag'' must be the name of the existing superclass.

The module automatically registers a subtype, calls a special callback at gtk initialization time and provides default implementations for some common methods (the list might grow in the future to enhance settor/gettor functionality).

The following methods are provided. All of them can be overriden in your package.

new
A simple generic new constructor is provided. It will simply call Gtk::Object::new with all the provided arguments.

GTK_INIT
This callback is called as early as possible after gtk was initialized, but not before. This can be used to register additional subtypes, argument types etc. It is similar to GTK_CLASS_INIT.

GTK_CLASS_INIT
Unlike the standard Gtk-callback of the same name, this method can be omitted in your package (while still being a valid Widget).

GTK_OBJECT_INIT
This callback can also be omitted, but this rarely makes sense ;)

BUGS

This was a pain to implement, you will not believe this when looking at the code, though.

AUTHOR

Marc Lehmann <pcg@goof.com>.

SEE ALSO

perl(1), the Gimp manpage, the Gimp::UI manpage, Gtk.