NAME

Gtk2 - Perl interface to the 2.x series of the Gimp Toolkit library

SYNOPSIS

use Gtk2 -init;
# Gtk2->init; works if you didn't use -init on use
my $window = Gtk2::Window->new ('toplevel');
my $button = Gtk2::Button->new ('Quit');
$button->signal_connect (clicked => sub { Gtk2->main_quit });
$window->add ($button);
$window->show_all;
Gtk2->main;

ABSTRACT

Perl bindings to the 2.x series of the Gtk+ widget set.
This module allows you to write graphical user interfaces in a 
perlish and object-oriented way, freeing you from the casting
and memory management in C, yet remaining very close in spirit
to original API.

DESCRIPTION

The Gtk2 module allows a perl developer to use the Gtk+ graphical user interface library. Find out more about Gtk+ at http://www.gtk.org.

The GTK+ Reference Manual is also a handy companion when writing Gtk programs in any language. http://developer.gnome.org/doc/API/2.0/gtk/ The perl bindings follow the C API very closely, and the C reference documentation should be considered the canonical source.

To discuss gtk2-perl, ask questions and flame/praise the authors, join gtk-perl-list@gnome.org at lists.gnome.org.

Also have a look at the gtk2-perl website and sourceforge project page, http://gtk2-perl.sourceforge.net

SEE ALSO

perl(1), Glib(3pm).

Gtk2::Gdk::Keysyms(3pm) contains a hash of key codes, culled from gdk/gdkkeysyms.h

Gtk2::api(3pm) describes how to map the C API into perl, and some of the important differences in the perl bindings.

Gtk2::Helper(3pm) contains stuff that makes writing Gtk2 programs a little easier.

Gtk2::SimpleList(3pm) makes the GtkListStore and GtkTreeModel a lot easier to use.

Gtk2 also provides code to make it relatively painless to create perl wrappers for other GLib/Gtk-based libraries. See Gtk2::CodeGen, Glib::PkgConfig, and ExtUtils::Depends. If you're writing bindings, you'll probably also be interested in Gtk2::devel, which is a supplement to Glib::devel and Glib::xsapi. The Binding Howto, at http://gtk2-perl.sourceforge.net/doc/binding_howto.pod.html, ties it all together.

AUTHORS

The gtk2-perl team:

muppet E<lt>scott at asofyet dot orgE<gt>
Ross McFarland E<lt>rwmcfa1 at neces dot comE<gt>
Jörn Reder E<lt>joern at zyn dot deE<gt>
Göran Thyni E<lt>gthyni at kirra dot netE<gt>
Chas Owens E<lt>alas at wilma dot widomaker dot comE<gt>
Guillaume Cottenceau E<lt>gc at mandrakesoft dot comE<gt>
Marc Lehmann E<lt>pcg at goof dot comE<gt>

COPYRIGHT AND LICENSE

Copyright 2003 by the gtk2-perl team.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.