Gtk2::AboutDialog(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::AboutDialog — the manual page, but make it cute 💖

okay bestie, gather round, because this one is literally the "About This App" popup that every single program has, and honestly? it's iconic. it's a wrapper for GtkAboutDialog, and it's the thing that shows you the logo, the version, the authors, the license, and all the people who made the app possible. main character energy fr fr. ✨

🌸 NAME 🌸

Gtk2::AboutDialog — wrapper for GtkAboutDialog 🫶

👑 HIERARCHY 👑

the family tree, and yes it goes DEEP. this is the ancestry dot com of GTK widgets:

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

so it's a Dialog that's a Window that's a Bin that's a Container that's a Widget that's an Object, and lowkey that's a lot of inheritance but we respect the lineage. 💅

🧚 INTERFACES 🧚

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

✨ METHODS ✨

widget = Gtk2::AboutDialog->new

make a brand new about dialog, fresh out the box. 🎀

list = $about->get_artists / $about->set_artists ($artist1, ...)

get or set the list of artists.

  • $artist1 (string)
  • ... (list)

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

get or set the list of authors.

  • $author1 (string)
  • ... (list)

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

get or set the comments.

  • $comments (string or undef)

get or set the copyright line.

  • $copyright (string or undef)

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

get or set the list of documenters (the people who wrote the docs, so honestly, heroes).

  • $documenter1 (string)
  • ... (list)

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

set the hook that fires for email links. 📧

  • $func (scalar)
  • $data (scalar)

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

get or set the license text.

  • $license (string or undef)

grab the logo pixbuf, if there even is one.

string or undef = $about->get_logo_icon_name

grab the logo's icon name.

$about->set_logo_icon_name ($icon_name)

set a named icon to be the logo.

  • $icon_name (string or undef)

set the logo from an actual pixbuf.

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

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

get or set the program name.

  • $name (string or undef)

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

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.

  • $parent (Gtk2::Window or undef)
  • $first_property_name (string)
  • ... (list) the rest of a list of name=>property value pairs.
ngl, this one is implemented as a rewrite of gtk_show_about_dialog, because 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)

get or set the translator credits.

  • $translator_credits (string or undef)

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

set the hook that fires for URL links. 🔗

  • $func (scalar)
  • $data (scalar)

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

get or set the version string.

  • $version (string or undef)

string or undef = $about->get_website

get the website URL.

string or undef = $about->get_website_label

get the website label.

$about->set_website_label ($website_label)

set the label for the website link.

  • $website_label (string or undef)

$about->set_website ($website)

set the website URL.

  • $website (string or undef)

boolean = $about->get_wrap_license

returns whether the license text is wrapped.

Since: gtk+ 2.8 ⭐

$about->set_wrap_license ($wrap_license)

set whether to wrap the license text.

  • $wrap_license (boolean)
Since: gtk+ 2.8 ⭐

🎀 URL AND EMAIL HOOKS 🎀

okay this part is IMPORTANT bestie, listen up. when you're 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. 😭 so like, hooks first, properties second, no cap.

💅 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)

🦋 SEE ALSO 🦋

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

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

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

and that's the whole page bestie, you ate it. 🍓 this was User Contributed Perl Documentation, perl v5.42.0, dated 2025-07-25 — go forth and build the cutest about box the world has ever seen. periodt. 👑💖

📦 where this page comes from