Gtk2::Notify.3pm

Langue: en

Version: 2009-02-28 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

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)


notify = Gtk2::Notify->new ($summary, $body=undef, $icon=undef, $attach=undef)

$summary (string)
$body (string)
$icon (string)
$attach (Gtk2::Widget or undef)

notify = Gtk2::Notify->new_with_status_icon ($summary, $body=undef, $icon=undef, $status_icon=undef)


notify = Gtk2::Notify->new_with_status_icon ($summary, $body=undef, $icon=undef, $status_icon=undef)

$summary (string)
$body (string)
$icon (string)
$status_icon (Gtk2::StatusIcon)

Since: gtk+ 2.9

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


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

$action (string)
$label (string)
$callback (scalar)
$userdata (scalar)

string = Gtk2::Notify->get_app_name


$notification->attach_to_status_icon ($status_icon)


$notification->attach_to_status_icon ($status_icon)

$status_icon (Gtk2::StatusIcon)

Since: gtk+ 2.9

$notification->attach_to_widget ($attach)


$notification->attach_to_widget ($attach)

$attach (Gtk2::Widget)

$notification->set_category ($category)


$notification->set_category ($category)

$category (string)

$notification->clear_actions


$notification->clear_actions


$notification->clear_hints


$notification->clear_hints


notify = $notification->close


notify = $notification->close


$notification->set_geometry_hints ($screen, $x, $y)


$notification->set_geometry_hints ($screen, $x, $y)

$screen (Gtk2::Gdk::Screen)
$x (integer)
$y (integer)

$notification->set_hint_byte_array ($key, $value)


$notification->set_hint_byte_array ($key, $value)

$key (string)
$value ((unknown))

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


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

$key (string)
$value (Glib::UChar)

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


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

$key (string)
$value (double)

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


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

$key (string)
$value (integer)

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


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

$key (string)
$value (scalar)

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


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

$key (string)
$value (string)

$notification->set_icon_from_pixbuf ($icon)


$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


notify = $notification->show


$notification->set_timeout ($timeout)


$notification->set_timeout ($timeout)

$timeout (integer)

Gtk2::Notify->uninit


boolean = $notification->update ($summary, $message=undef, $icon=undef)


boolean = $notification->update ($summary, $message=undef, $icon=undef)

$summary (string)
$message (string)
$icon (string)

$notification->set_urgency ($urgency)


$notification->set_urgency ($urgency)

$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

'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 (C) 2006-2008 by Florian Ragwitz