Gtk2::AboutDialog

NAME

Gtk2::AboutDialog − wrapper for GtkAboutDialog

HIERARCHY

Glib::Object
+−−−−Glib::InitiallyUnowned
+−−−−Gtk2::Object
+−−−−Gtk2::Widget
+−−−−Gtk2::Container
+−−−−Gtk2::Bin
+−−−−Gtk2::Window
+−−−−Gtk2::Dialog
+−−−−Gtk2::AboutDialog

INTERFACES

Glib::Object::_Unregistered::AtkImplementorIface
Gtk2::Buildable

METHODS

widget = Gtk2::AboutDialog−>new
list = $about−>get_artists
$about−>set_artists ($artist1, ...)

$artist1 (string)

... (list)

list = $about−>get_authors
$about−>set_authors ($author1, ...)

$author1 (string)

... (list)

string or undef = $about−>get_comments
$about−>set_comments ($comments)

$comments (string or undef)

string or undef = $about−>get_copyright
$about−>set_copyright ($copyright)

$copyright (string or undef)

list = $about−>get_documenters
$about−>set_documenters ($documenter1, ...)

$documenter1 (string)

... (list)

Gtk2::AboutDialog−>set_email_hook ($func, $data=undef)

$func (scalar)

$data (scalar)

string or undef = $about−>get_license
$about−>set_license ($license)

$license (string or undef)

pixbuf or undef = $about−>get_logo
string or undef = $about−>get_logo_icon_name
$about−>set_logo_icon_name ($icon_name)

$icon_name (string or undef)

$about−>set_logo ($logo)

$logo (Gtk2::Gdk::Pixbuf or undef)

string or undef = $about−>get_program_name
$about−>set_program_name ($name)

$name (string or undef)

Gtk2−>show_about_dialog ($parent, $first_property_name, ...)

$parent (Gtk2::Window or undef)

$first_property_name (string)

... (list) the rest of a list of name=>property value pairs.

A convenience function for showing an application’s about box. The constructed dialog is "transient for" $parent and associated with that widget so it’s reused for future invocations. The dialog is non-modal and hidden by any response.

(This is implemented as a rewrite of "gtk_show_about_dialog" since it’s not easy to construct a varargs call to that actual function. The intention is to behave the same though.)

string or undef = $about−>get_translator_credits
$about−>set_translator_credits ($translator_credits)

$translator_credits (string or undef)

Gtk2::AboutDialog−>set_url_hook ($func, $data=undef)

$func (scalar)

$data (scalar)

string or undef = $about−>get_version
$about−>set_version ($version)

$version (string or undef)

string or undef = $about−>get_website
string or undef = $about−>get_website_label
$about−>set_website_label ($website_label)

$website_label (string or undef)

$about−>set_website ($website)

$website (string or undef)

boolean = $about−>get_wrap_license
Since: gtk+ 2.8

$about−>set_wrap_license ($wrap_license)

$wrap_license (boolean)

Since: gtk+ 2.8

URL AND EMAIL HOOKS

When setting the website and email hooks for the Gtk2::AboutDialog widget, you should remember that the order is important: you should set the hook functions before setting the website and email URL properties, like this:

$about_dialog−>set_url_hook(\&launch_web_browser);
$about_dialog−>set_website($app_website);

otherwise the AboutDialog will not display the website and the email addresses as clickable.

PROPERTIES

’artists’ (Glib::Strv : default undef : readable / writable / private)

List of people who have contributed artwork to the program

’authors’ (Glib::Strv : default undef : readable / writable / private)

List of authors of the program

’comments’ (string : default undef : readable / writable / private)

Comments about the program

’copyright’ (string : default undef : readable / writable / private)

Copyright information for the program

’documenters’ (Glib::Strv : default undef : readable / writable /
private)

List of people documenting the program

’license’ (string : default undef : readable / writable / private)

The license of the program

’logo’ (Gtk2::Gdk::Pixbuf : default undef : readable / writable /
private)

A logo for the about box. If this is not set, it defaults to gtk_window_get_default_icon_list()

’logo−icon−name’ (string : default undef : readable / writable /
private)

A named icon to use as the logo for the about box.

’program−name’ (string : default undef : readable / writable / private)

The name of the program. If this is not set, it defaults to g_get_application_name()

’translator−credits’ (string : default undef : readable / writable /
private)

Credits to the translators. This string should be marked as translatable

’version’ (string : default undef : readable / writable / private)

The version of the program

’website’ (string : default undef : readable / writable / private)

The URL for the link to the website of the program

’website−label’ (string : default undef : readable / writable /
private)

The label for the link to the website of the program. If this is not set, it defaults to the URL

’wrap−license’ (boolean : default false : readable / writable /
private)

Whether to wrap the license text.

SIGNALS

boolean = activate-link (Gtk2::AboutDialog, string)

SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin, Gtk2::Window, Gtk2::Dialog

COPYRIGHT

Copyright (C) 2003−2011 by the gtk2−perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.