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

SIGNALS

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

SEE ALSO

186       Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget,
187       Gtk2::Container, Gtk2::Bin, Gtk2::Window, Gtk2::Dialog
188
190       Copyright (C) 2003-2011 by the gtk2-perl team.
191
192       This software is licensed under the LGPL.  See Gtk2 for a full notice.
193
194
195
196perl v5.30.1                      2020-01-30              Gtk2::AboutDialog(3)
Impressum