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

$about->set_artists ($artist1, ...)

$artist1 (string)
... (list)

$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 / static-nick / static-blurb): List of people who have contributed artwork to the program
'authors' (Glib::Strv : default undef : readable / writable / private / static-nick / static-blurb): List of authors of the program
'comments' (string : default undef : readable / writable / private / static-nick / static-blurb): Comments about the program
'copyright' (string : default undef : readable / writable / private / static-nick / static-blurb): Copyright information for the program
'documenters' (Glib::Strv : default undef : readable / writable / private / static-nick / static-blurb): List of people documenting the program
'license' (string : default undef : readable / writable / private / static-nick / static-blurb): The license of the program
'logo' (Gtk2::Gdk::Pixbuf : default undef : readable / writable / private / static-nick / static-blurb): 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 / static-nick / static-blurb): A named icon to use as the logo for the about box.
'program-name' (string : default undef : readable / writable / private / static-nick / static-blurb): 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 / static-nick / static-blurb): Credits to the translators. This string should be marked as translatable
'version' (string : default undef : readable / writable / private / static-nick / static-blurb): The version of the program
'website' (string : default undef : readable / writable / private / static-nick / static-blurb): The URL for the link to the website of the program
'website-label' (string : default undef : readable / writable / private / static-nick / static-blurb): 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 / static-nick / static-blurb): Whether to wrap the license text.

SIGNALS

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

COPYRIGHT

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