Gtk3(3pm) User Contributed Perl Documentation Gtk3(3pm)NAME
Gtk3 - Perl interface to the 3.x series of the gtk+ toolkit
SYNOPSIS
use Gtk3 -init;
my $window = Gtk3::Window->new ('toplevel');
my $button = Gtk3::Button->new ('Quit');
$button->signal_connect (clicked => sub { Gtk3::main_quit });
$window->add ($button);
$window->show_all;
Gtk3::main;
ABSTRACT
Perl bindings to the 3.x series of the gtk+ toolkit. 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 Gtk3 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 Gtk3 programs in Perl: <http://developer.gnome.org/gtk3/stable/>. The
Perl bindings follow the C API very closely, and the C reference documentation should be considered the canonical source.
To discuss Gtk3 and ask questions join gtk-perl-list@gnome.org at http://mail.gnome.org/mailman/listinfo/gtk-perl-list
<http://mail.gnome.org/mailman/listinfo/gtk-perl-list>.
Also have a look at the gtk2-perl website and sourceforge project page, http://gtk2-perl.sourceforge.net
<http://gtk2-perl.sourceforge.net>.
Porting from Gtk2 to Gtk3
The majority of the API has not changed, so as a first approximation you can run "s/Gtk2/Gtk3/" on your application. A big exception to
this rule is APIs that were deprecated in gtk+ 2.x -- these were all removed from gtk+ 3.0 and thus from Gtk3. The migration guide at
<http://developer.gnome.org/gtk3/stable/migrating.html> describes what to use instead. Apart from this, here is a list of some other
incompatible differences between Gtk2 and Gtk3:
o The call syntax for class-static methods is now always "Gtk3::Stock::lookup" instead of "Gtk3::Stock->lookup".
o The %Gtk2::Gdk::Keysyms hash is gone; instead of "Gtk2::Gdk::Keysyms{XYZ}", use "Gtk3::Gdk::KEY_XYZ".
o The Gtk2::Pango compatibility wrapper was not carried over; simply use the namespace "Pango" everywhere. It gets set up automatically
when loading Gtk3.
o The Gtk3::Menu menu position callback passed to popup() does not receive x and y parameters anymore.
Note also that Gtk3::CHECK_VERSION will always fail when passed 2.y.z, so if you have any existing version checks in your code, you will
most likely need to remove them.
SEE ALSO
Glib
Glib::Object::Introspection
AUTHORS
Torsten Schoenfeld <kaffeetisch@gmx.de>
COPYRIGHT AND LICENSE
Copyright (C) 2011-2012 by Torsten Schoenfeld <kaffeetisch@gmx.de>
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.1 of the License, or (at your option) any later version.
perl v5.14.2 2012-06-23 Gtk3(3pm)
Check Out this Related Man Page
Glib::Object::Introspection(3pm) User Contributed Perl Documentation Glib::Object::Introspection(3pm)NAME
Glib::Object::Introspection - Dynamically create Perl language bindings
SYNOPSIS
use Glib::Object::Introspection;
Glib::Object::Introspection->setup(
basename => 'Gtk',
version => '3.0',
package => 'Gtk3');
# now GtkWindow, to mention just one example, is available as
# Gtk3::Window, and you can call gtk_window_new as Gtk3::Window->new
ABSTRACT
Glib::Object::Introspection uses the gobject-introspection and libffi projects to dynamically create Perl bindings for a wide variety of
libraries. Examples include gtk+, webkit, libsoup and many more.
DESCRIPTION
"Glib::Object::Introspection->setup"
To allow Glib::Object::Introspection to create bindings for a library, it must have installed a typelib file, for example
"$prefix/lib/girepository-1.0/Gtk-3.0.typelib". In your code you then simply call "Glib::Object::Introspection->setup" to set everything
up. This method takes a couple of key-value pairs as arguments. These three are mandatory:
basename => $basename
The basename of the library that should be wrapped. If your typelib is called "Gtk-3.0.typelib", then the basename is 'Gtk'.
version => $version
The particular version of the library that should be wrapped, in string form. For "Gtk-3.0.typelib", it is '3.0'.
package => $package
The name of the Perl package where every class and method of the library should be rooted. If a library with basename 'Gtk' contains
an object 'GtkWindow', and you pick as the package 'Gtk3', then that object will be available as 'Gtk3::Window'.
The rest are optional:
search_path => $search_path
A path that should be used when looking for typelibs. If you use typelibs from system directories, or if your environment is set up
correctly, then this should not be necessary.
name_corrections => { auto_name => new_name, ... }
A hash ref that is used to rename functions and methods. Use this if you don't like the automatically generated mapping for a function
or method. For example, if "g_file_hash" is automatically represented as "Glib::IO::file_hash" but you want "Glib::IO::File::hash"
then pass
name_corrections => {
'Glib::IO::file_hash' => 'Glib::IO::File::hash'
}
class_static_methods => [ function1, ... ]
An array ref of function names that you want to be treated as class-static methods. That is, if you want be able to call
"Gtk3::Window::list_toplevels" as "Gtk3::Window->list_toplevels", then pass
class_static_methods => [
'Gtk3::Window::list_toplevels'
]
The function names refer to those after name corrections.
flatten_array_ref_return_for => [ function1, ... ]
An array ref of function names that return an array ref that you want to be flattened so that they return plain lists. For example
flatten_array_ref_return_for => [
'Gtk3::Window::list_toplevels'
]
The function names refer to those after name corrections. Functions occuring in "flatten_array_ref_return_for" may also occur in
"class_static_methods".
handle_sentinel_boolean_for => [ function1, ... ]
An array ref of function names that return multiple values, the first of which is to be interpreted as indicating whether the rest of
the returned values are valid. This frequently occurs with functions that have out arguments; the boolean then indicates whether the
out arguments have been written. With "handle_sentinel_boolean_for", the first return value is taken to be the sentinel boolean. If
it is true, the rest of the original return values will be returned, and otherwise an empty list will be returned.
handle_sentinel_boolean_for => [
'Gtk3::TreeSelection::get_selected'
]
The function names refer to those after name corrections. Functions occuring in "handle_sentinel_boolean_for" may also occur in
"class_static_methods".
"Glib::Object::Introspection->invoke"
To invoke specific functions manually, you can use the low-level "Glib::Object::Introspection->invoke".
Glib::Object::Introspection->invoke(
$basename, $namespace, $function, @args)
o $basename is the basename of a library, like 'Gtk'.
o $namespace refers to a namespace inside that library, like 'Window'. Use undef here if you want to call a library-global function.
o $function is the name of the function you want to invoke. It can also refer to the name of a constant.
o @args are the arguments that should be passed to the function. For a method, this should include the invocant. For a constructor,
this should include the package name.
"Glib::Object::Introspection->invoke" returns whatever the function being invoked returns.
Overrides
To override the behavior of a specific function or method, create an appropriately named sub in the correct package and have it call
"Glib::Object::Introspection->invoke". Say you want to override "Gtk3::Window::list_toplevels", then do this:
sub Gtk3::Window::list_toplevels {
# ...do something...
my $ref = Glib::Object::Introspection->invoke (
'Gtk', 'Window', 'list_toplevels',
@_);
# ...do something...
return wantarray ? @$ref : $ref->[$#$ref];
}
The sub's name and package must be those after name corrections.
Converting a Perl variable to a GValue
If you need to marshal into a GValue, then Glib::Object::Introspection cannot do this automatically because the type information is
missing. If you do have this information in your module, however, you can use Glib::Object::Introspection::GValueWrapper to do the
conversion. In the wrapper for a function that expects a GValue, do this:
...
my $type = ...; # somehow get the package name that
# corresponds to the correct GType
my $real_value =
Glib::Object::Introspection::GValueWrapper->new ($type, $value);
# now use Glib::Object::Introspection->invoke and
# substitute $real_value where you'd use $value
...
SEE ALSO
gobject-introspection: <http://live.gnome.org/GObjectIntrospection>
libffi: <http://sourceware.org/libffi/>
AUTHORS
Emmanuele Bassi <ebassi at linux intel com>
muppet <scott asofyet org>
Torsten Schoenfeld <kaffeetisch at gmx de>
LICENSE
This library is free software; you can redistribute it and/or modify it under the terms of the Lesser General Public License (LGPL). For
more information, see http://www.fsf.org/licenses/lgpl.txt
perl v5.14.2 2012-05-21 Glib::Object::Introspection(3pm)