basewidget

Section: User Contributed Perl Documentation (3)
Updated: 2001-12-07
Index
Return to Main Contents

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

This document was created by man2html, using the manual pages.
Time: 02:08:05 GMT, April 20, 2024