Gtk2::AboutDialog(3pm)					User Contributed Perl Documentation				    Gtk2::AboutDialog(3pm)

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, ...)
       o   $artist1 (string)

       o   ... (list)

   list = $about->get_authors
   $about->set_authors ($author1, ...)
       o   $author1 (string)

       o   ... (list)

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

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

   list = $about->get_documenters
   $about->set_documenters ($documenter1, ...)
       o   $documenter1 (string)

       o   ... (list)

   Gtk2::AboutDialog->set_email_hook ($func, $data=undef)
       o   $func (scalar)

       o   $data (scalar)

   string or undef = $about->get_license
   $about->set_license ($license)
       o   $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)
       o   $icon_name (string or undef)

   $about->set_logo ($logo)
       o   $logo (Gtk2::Gdk::Pixbuf or undef)

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

   Gtk2->show_about_dialog ($parent, $first_property_name, ...)
       o   $parent (Gtk2::Window or undef)

       o   $first_property_name (string)

       o   ... (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)
       o   $translator_credits (string or undef)

   Gtk2::AboutDialog->set_url_hook ($func, $data=undef)
       o   $func (scalar)

       o   $data (scalar)

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

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

   $about->set_website ($website)
       o   $website (string or undef)

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

   $about->set_wrap_license ($wrap_license)
       o   $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.

perl v5.14.2							    2012-05-27						    Gtk2::AboutDialog(3pm)