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)
       •   $summary (string)

       •   $body (string)

       •   $icon (string)

   $notification->add_action ($action, $label, $callback, $userdata=undef)
       •   $action (string)

       •   $label (string)

       •   $callback (scalar)

       •   $userdata (scalar)

   string = Gtk2::Notify->get_app_name
   $notification->set_category ($category)
       •   $category (string)

   $notification->clear_actions
   $notification->clear_hints
   notify = $notification->close
   $notification->set_hint_byte_array ($key, $value)
       •   $key (string)

       •   $value ((unknown))

   $notification->set_hint_byte ($key, $value)
       •   $key (string)

       •   $value (Glib::UChar)

   $notification->set_hint_double ($key, $value)
       •   $key (string)

       •   $value (double)

   $notification->set_hint_int32 ($key, $value)
       •   $key (string)

       •   $value (integer)

   $notification->set_hint ($key, $value)
       •   $key (string)

       •   $value (scalar)

   $notification->set_hint_string ($key, $value)
       •   $key (string)

       •   $value (string)

   $notification->set_icon_from_pixbuf ($icon)
       •   $icon (Gtk2::Gdk::Pixbuf)

   boolean = Gtk2::Notify->init ($app_name)
       •   $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)
       •   $timeout (integer)

   Gtk2::Notify->uninit
   boolean = $notification->update ($summary, $message=undef, $icon=undef)
       •   $summary (string)

       •   $message (string)

       •   $icon (string)

   $notification->set_urgency ($urgency)
       •   $urgency (Gtk2::Notify::NotifyUrgency)

PROPERTIES

       'app-name' (string : default undef : readable / writable)
           The application name to use for this notification

       'body' (string : default undef : readable / writable / construct)
           The message body text

       'closed-reason' (integer : default -1 : readable)
           The reason code for why the notification was closed

       'icon-name' (string : default undef : readable / writable / construct)
           The icon filename or icon theme-compliant name

       'id' (integer : default 0 : readable / writable / construct)
           The notification ID

       'summary' (string : default undef : readable / writable / construct)
           The summary text

SIGNALS

       closed (Gtk2::Notify)

ENUMS AND FLAGS

   enum Gtk2::Notify::NotifyUrgency
       •   'low' / 'NOTIFY_URGENCY_LOW'

       •   'normal' / 'NOTIFY_URGENCY_NORMAL'

       •   '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:

       •   AnnoCPAN: Annotated CPAN documentation

           <http://annocpan.org/dist/Gtk2-Notify>

       •   CPAN Ratings

           <http://cpanratings.perl.org/d/Gtk2-Notify>

       •   RT: CPAN's request tracker

           <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Gtk2-Notify>

       •   Search CPAN

           <http://search.cpan.org/dist/Gtk2-Notify>

SEE ALSO

       Gtk2::Notify, Glib::Object

COPYRIGHT

       Copyright (C) 2006-2008 by Florian Ragwitz