Gtk2::Notify(3pm)

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

NAME

6       Gtk2::Notify - Perl interface to libnotify
7

HIERARCHY

9         Glib::Object
10         +----Gtk2::Notify
11

SYNOPSIS

13           use Gtk2::Notify -init, "app_name";
14
15           my $notification = Gtk2::Notify->new(
16                   $summary,
17                   $message,
18                   $icon,
19                   $attach_widget
20           );
21           $notification->show;
22

INITIALISATION

24           use Gtk2::Notify qw/-init app_name/;
25
26       -init
27           Importing Gtk2::Notify with the -init option requires one
28           additional argument: the application name to use. This is
29           equivalent to "Gtk2::Notify->init($app_name)".
30

METHODS

32   notify = Gtk2::Notify->new ($summary, $body=undef, $icon=undef,
33       $attach=undef)
34           ·   $summary (string)
35
36           ·   $body (string)
37
38           ·   $icon (string)
39
40           ·   $attach (Gtk2::Widget or undef)
41
42   notify = Gtk2::Notify->new_with_status_icon ($summary, $body=undef,
43       $icon=undef, $status_icon=undef)
44           ·   $summary (string)
45
46           ·   $body (string)
47
48           ·   $icon (string)
49
50           ·   $status_icon (Gtk2::StatusIcon)
51
52           Since: gtk+ 2.9
53
54   $notification->add_action ($action, $label, $callback, $userdata=undef)
55           ·   $action (string)
56
57           ·   $label (string)
58
59           ·   $callback (scalar)
60
61           ·   $userdata (scalar)
62
63   string = Gtk2::Notify->get_app_name
64   $notification->attach_to_status_icon ($status_icon)
65           ·   $status_icon (Gtk2::StatusIcon)
66
67           Since: gtk+ 2.9
68
69   $notification->attach_to_widget ($attach)
70           ·   $attach (Gtk2::Widget)
71
72   $notification->set_category ($category)
73           ·   $category (string)
74
75   $notification->clear_actions
76   $notification->clear_hints
77   notify = $notification->close
78   $notification->set_geometry_hints ($screen, $x, $y)
79           ·   $screen (Gtk2::Gdk::Screen)
80
81           ·   $x (integer)
82
83           ·   $y (integer)
84
85   $notification->set_hint_byte_array ($key, $value)
86           ·   $key (string)
87
88           ·   $value ((unknown))
89
90   $notification->set_hint_byte ($key, $value)
91           ·   $key (string)
92
93           ·   $value (Glib::UChar)
94
95   $notification->set_hint_double ($key, $value)
96           ·   $key (string)
97
98           ·   $value (double)
99
100   $notification->set_hint_int32 ($key, $value)
101           ·   $key (string)
102
103           ·   $value (integer)
104
105   $notification->set_hint ($key, $value)
106           ·   $key (string)
107
108           ·   $value (scalar)
109
110   $notification->set_hint_string ($key, $value)
111           ·   $key (string)
112
113           ·   $value (string)
114
115   $notification->set_icon_from_pixbuf ($icon)
116           ·   $icon (Gtk2::Gdk::Pixbuf)
117
118   boolean = Gtk2::Notify->init ($app_name)
119           ·   $app_name (string)
120
121   boolean = Gtk2::Notify->is_initted
122   list = Gtk2::Notify->get_server_caps
123   (notify, name, vendor, version, spec_version) =
124       Gtk2::Notify->get_server_info
125   notify = $notification->show
126   $notification->set_timeout ($timeout)
127           ·   $timeout (integer)
128
129   Gtk2::Notify->uninit
130   boolean = $notification->update ($summary, $message=undef, $icon=undef)
131           ·   $summary (string)
132
133           ·   $message (string)
134
135           ·   $icon (string)
136
137   $notification->set_urgency ($urgency)
138           ·   $urgency (Gtk2::Notify::NotifyUrgency)
139

PROPERTIES

141       'attach-widget' (Gtk2::Widget : readable / writable / construct)
142           The widget to attach the notification to
143
144       'body' (string : readable / writable / construct)
145           The message body text
146
147       'closed-reason' (integer : readable)
148           The reason code for why the notification was closed
149
150       'icon-name' (string : readable / writable / construct)
151           The icon filename or icon theme-compliant name
152
153       'id' (integer : readable / writable / construct)
154           The notification ID
155
156       'status-icon' (Gtk2::StatusIcon : readable / writable / construct)
157           The status icon to attach the notification to
158
159       'summary' (string : readable / writable / construct)
160           The summary text
161

SIGNALS

163       closed (Gtk2::Notify)
164

ENUMS AND FLAGS

166   enum Gtk2::Notify::NotifyUrgency
167       ·   'low' / 'NOTIFY_URGENCY_LOW'
168
169       ·   'normal' / 'NOTIFY_URGENCY_NORMAL'
170
171       ·   'critical' / 'NOTIFY_URGENCY_CRITICAL'
172

BUGS

174       Please report any bugs or feature requests to "bug-gtk2-notify at
175       rt.cpan.org", or through the web interface at
176       http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Gtk2-Notify
177       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Gtk2-Notify>.  I will
178       be notified, and then you'll automatically be notified of progress on
179       your bug as I make changes.
180

SUPPORT

182       You can find documentation for this module with the perldoc command.
183
184           perldoc Gtk2::Notify
185
186       You can also look for information at:
187
188       ·   AnnoCPAN: Annotated CPAN documentation
189
190           http://annocpan.org/dist/Gtk2-Notify
191           <http://annocpan.org/dist/Gtk2-Notify>
192
193       ·   CPAN Ratings
194
195           http://cpanratings.perl.org/d/Gtk2-Notify
196           <http://cpanratings.perl.org/d/Gtk2-Notify>
197
198       ·   RT: CPAN's request tracker
199
200           http://rt.cpan.org/NoAuth/Bugs.html?Dist=Gtk2-Notify
201           <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Gtk2-Notify>
202
203       ·   Search CPAN
204
205           http://search.cpan.org/dist/Gtk2-Notify
206           <http://search.cpan.org/dist/Gtk2-Notify>
207

COPYRIGHT

212       Copyright (C) 2006-2008 by Florian Ragwitz
213
214
215
216perl v5.12.0                      2010-05-02                   Gtk2::Notify(3)