--- name: "Gtk2::AboutDialog" section: "3pm" platform: "linux" package: "libgtk2-perl-doc" version: "2:1.24992-1" release: "Debian 10 (Buster)" platforms: ["linux"] url: "https://new.carta.tech/Gtk2::AboutDialog" --- # Gtk2::AboutDialog(3pm) wrapper for GtkAboutDialog ## 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.