1Gtk2::AboutDialog(3)  User Contributed Perl Documentation Gtk2::AboutDialog(3)
2
3
4

NAME

6       Gtk2::AboutDialog - wrapper for GtkAboutDialog
7

HIERARCHY

9         Glib::Object
10         +----Glib::InitiallyUnowned
11              +----Gtk2::Object
12                   +----Gtk2::Widget
13                        +----Gtk2::Container
14                             +----Gtk2::Bin
15                                  +----Gtk2::Window
16                                       +----Gtk2::Dialog
17                                            +----Gtk2::AboutDialog
18

INTERFACES

20         Glib::Object::_Unregistered::AtkImplementorIface
21         Gtk2::Buildable
22

METHODS

24   widget = Gtk2::AboutDialog->new
25   list = $about->get_artists
26   $about->set_artists ($artist1, ...)
27       •   $artist1 (string)
28
29       •   ... (list)
30
31   list = $about->get_authors
32   $about->set_authors ($author1, ...)
33       •   $author1 (string)
34
35       •   ... (list)
36
37   string or undef = $about->get_comments
38   $about->set_comments ($comments)
39       •   $comments (string or undef)
40
41   string or undef = $about->get_copyright
42   $about->set_copyright ($copyright)
43       •   $copyright (string or undef)
44
45   list = $about->get_documenters
46   $about->set_documenters ($documenter1, ...)
47       •   $documenter1 (string)
48
49       •   ... (list)
50
51   Gtk2::AboutDialog->set_email_hook ($func, $data=undef)
52       •   $func (scalar)
53
54       •   $data (scalar)
55
56   string or undef = $about->get_license
57   $about->set_license ($license)
58       •   $license (string or undef)
59
60   pixbuf or undef = $about->get_logo
61   string or undef = $about->get_logo_icon_name
62   $about->set_logo_icon_name ($icon_name)
63       •   $icon_name (string or undef)
64
65   $about->set_logo ($logo)
66       •   $logo (Gtk2::Gdk::Pixbuf or undef)
67
68   string or undef = $about->get_program_name
69   $about->set_program_name ($name)
70       •   $name (string or undef)
71
72   Gtk2->show_about_dialog ($parent, $first_property_name, ...)
73       •   $parent (Gtk2::Window or undef)
74
75       •   $first_property_name (string)
76
77       •   ... (list) the rest of a list of name=>property value pairs.
78
79       A convenience function for showing an application's about box.  The
80       constructed dialog is "transient for" $parent and associated with that
81       widget so it's reused for future invocations.  The dialog is non-modal
82       and hidden by any response.
83
84       (This is implemented as a rewrite of "gtk_show_about_dialog" since it's
85       not easy to construct a varargs call to that actual function.  The
86       intention is to behave the same though.)
87
88   string or undef = $about->get_translator_credits
89   $about->set_translator_credits ($translator_credits)
90       •   $translator_credits (string or undef)
91
92   Gtk2::AboutDialog->set_url_hook ($func, $data=undef)
93       •   $func (scalar)
94
95       •   $data (scalar)
96
97   string or undef = $about->get_version
98   $about->set_version ($version)
99       •   $version (string or undef)
100
101   string or undef = $about->get_website
102   string or undef = $about->get_website_label
103   $about->set_website_label ($website_label)
104       •   $website_label (string or undef)
105
106   $about->set_website ($website)
107       •   $website (string or undef)
108
109   boolean = $about->get_wrap_license
110       Since: gtk+ 2.8
111
112   $about->set_wrap_license ($wrap_license)
113       •   $wrap_license (boolean)
114
115       Since: gtk+ 2.8
116

URL AND EMAIL HOOKS

118       When setting the website and email hooks for the Gtk2::AboutDialog
119       widget, you should remember that the order is important: you should set
120       the hook functions before setting the website and email URL properties,
121       like this:
122
123         $about_dialog->set_url_hook(\&launch_web_browser);
124         $about_dialog->set_website($app_website);
125
126       otherwise the AboutDialog will not display the website and the email
127       addresses as clickable.
128

PROPERTIES

130       'artists' (Glib::Strv : default undef : readable / writable / private /
131       static-nick / static-blurb)
132           List of people who have contributed artwork to the program
133
134       'authors' (Glib::Strv : default undef : readable / writable / private /
135       static-nick / static-blurb)
136           List of authors of the program
137
138       'comments' (string : default undef : readable / writable / private /
139       static-nick / static-blurb)
140           Comments about the program
141
142       'copyright' (string : default undef : readable / writable / private /
143       static-nick / static-blurb)
144           Copyright information for the program
145
146       'documenters' (Glib::Strv : default undef : readable / writable /
147       private / static-nick / static-blurb)
148           List of people documenting the program
149
150       'license' (string : default undef : readable / writable / private /
151       static-nick / static-blurb)
152           The license of the program
153
154       'logo' (Gtk2::Gdk::Pixbuf : default undef : readable / writable /
155       private / static-nick / static-blurb)
156           A logo for the about box. If this is not set, it defaults to
157           gtk_window_get_default_icon_list()
158
159       'logo-icon-name' (string : default undef : readable / writable /
160       private / static-nick / static-blurb)
161           A named icon to use as the logo for the about box.
162
163       'program-name' (string : default undef : readable / writable / private
164       / static-nick / static-blurb)
165           The name of the program. If this is not set, it defaults to
166           g_get_application_name()
167
168       'translator-credits' (string : default undef : readable / writable /
169       private / static-nick / static-blurb)
170           Credits to the translators. This string should be marked as
171           translatable
172
173       'version' (string : default undef : readable / writable / private /
174       static-nick / static-blurb)
175           The version of the program
176
177       'website' (string : default undef : readable / writable / private /
178       static-nick / static-blurb)
179           The URL for the link to the website of the program
180
181       'website-label' (string : default undef : readable / writable / private
182       / static-nick / static-blurb)
183           The label for the link to the website of the program. If this is
184           not set, it defaults to the URL
185
186       'wrap-license' (boolean : default false : readable / writable / private
187       / static-nick / static-blurb)
188           Whether to wrap the license text.
189

SIGNALS

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

SEE ALSO

194       Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget,
195       Gtk2::Container, Gtk2::Bin, Gtk2::Window, Gtk2::Dialog
196
198       Copyright (C) 2003-2011 by the gtk2-perl team.
199
200       This software is licensed under the LGPL.  See Gtk2 for a full notice.
201
202
203
204perl v5.32.1                      2021-01-27              Gtk2::AboutDialog(3)
Impressum