Gtk2::Notify(3pm)
NAME
Gtk2::Notify - Perl interface to libnotify
HIERARCHY
Glib::Object
+----Gtk2::Notify
SYNOPSIS
use Gtk2::Notify -init, "app_name";
my $notification = Gtk2::Notify->new(
$summary,
$message,
$icon,
$attach_widget
);
$notification->show;
INITIALISATION
- use Gtk2::Notify qw/-init app_name/;
- -init
- Importing Gtk2::Notify with the -init option requires one
additional argument: the application name to use. This is
equivalent to "Gtk2::Notify->init($app_name)".
METHODS
- notify = Gtk2::Notify->new ($summary, $body=undef, $icon=undef,
- $attach=undef)
o $summary (string) - o $body (string)
- o $icon (string)
- o $attach (Gtk2::Widget or undef)
- notify = Gtk2::Notify->new_with_status_icon ($summary, $body=undef,
- $icon=undef, $status_icon=undef) o $summary (string)
- o $body (string)
- o $icon (string)
- o $status_icon (Gtk2::StatusIcon)
- Since: gtk+ 2.9
- $notification->add_action ($action, $label, $callback, $userdata=undef)
- o $action (string)
- o $label (string)
- o $callback (scalar)
- o $userdata (scalar)
- string = Gtk2::Notify->get_app_name $notification->attach_to_status_icon ($status_icon)
- o $status_icon (Gtk2::StatusIcon)
- Since: gtk+ 2.9
- $notification->attach_to_widget ($attach)
- o $attach (Gtk2::Widget)
- $notification->set_category ($category)
- o $category (string)
- $notification->clear_actions $notification->clear_hints notify = $notification->close $notification->set_geometry_hints ($screen, $x, $y)
- o $screen (Gtk2::Gdk::Screen)
- o $x (integer)
- o $y (integer)
- $notification->set_hint_byte_array ($key, $value)
- o $key (string)
- o $value ((unknown))
- $notification->set_hint_byte ($key, $value)
- o $key (string)
- o $value (Glib::UChar)
- $notification->set_hint_double ($key, $value)
- o $key (string)
- o $value (double)
- $notification->set_hint_int32 ($key, $value)
- o $key (string)
- o $value (integer)
- $notification->set_hint ($key, $value)
- o $key (string)
- o $value (scalar)
- $notification->set_hint_string ($key, $value)
- o $key (string)
- o $value (string)
- $notification->set_icon_from_pixbuf ($icon)
- o $icon (Gtk2::Gdk::Pixbuf)
- boolean = Gtk2::Notify->init ($app_name)
- o $app_name (string)
- boolean = Gtk2::Notify->is_initted list = Gtk2::Notify->get_server_caps (notify, name, vendor, version, spec_version) =
- Gtk2::Notify->get_server_info
- notify = $notification->show $notification->set_timeout ($timeout)
- o $timeout (integer)
- Gtk2::Notify->uninit
boolean = $notification->update ($summary, $message=undef, $icon=undef) - o $summary (string)
- o $message (string)
- o $icon (string)
- $notification->set_urgency ($urgency)
- o $urgency (Gtk2::Notify::NotifyUrgency)
PROPERTIES
- 'attach-widget' (Gtk2::Widget : readable / writable / construct)
- The widget to attach the notification to
- 'body' (string : readable / writable / construct)
- The message body text
- 'closed-reason' (integer : readable)
- The reason code for why the notification was closed
- 'icon-name' (string : readable / writable / construct)
- The icon filename or icon theme-compliant name
- 'id' (integer : readable / writable / construct)
- The notification ID
- 'status-icon' (Gtk2::StatusIcon : readable / writable / construct)
- The status icon to attach the notification to
- 'summary' (string : readable / writable / construct)
- The summary text
SIGNALS
closed (Gtk2::Notify)
ENUMS AND FLAGS
- enum Gtk2::Notify::NotifyUrgency
- o 'low' / 'NOTIFY_URGENCY_LOW'
- o 'normal' / 'NOTIFY_URGENCY_NORMAL'
- o 'critical' / 'NOTIFY_URGENCY_CRITICAL'
BUGS
Please report any bugs or feature requests to "bug-gtk2-notify at
rt.cpan.org", or through the web interface at
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Gtk2-Notify>. I will
be notified, and then you'll automatically be notified of progress on
your bug as I make changes.
SUPPORT
- You can find documentation for this module with the perldoc command.
- perldoc Gtk2::Notify
- You can also look for information at:
- o AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/Gtk2-Notify>- o CPAN Ratings
<http://cpanratings.perl.org/d/Gtk2-Notify>- o RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Gtk2-Notify>- o Search CPAN
<http://search.cpan.org/dist/Gtk2-Notify>
SEE ALSO
Gtk2::Notify, Glib::Object
COPYRIGHT
- Copyright (C) 2006-2008 by Florian Ragwitz