TrayManager(3pm)

NAME

Gtk2::TrayManager - Perl bindings for EggTrayManager

SYNOPSIS

use Gtk2 -init;
use Gtk2::TrayManager;

my $screen = Gtk2::Gdk::Screen->get_default;

if (Gtk2::TrayManager->check_running($screen)) {
        print STDERR "A tray manager is already running, sorry!\n";
        exit 256;
}

my $tray = Gtk2::TrayManager->new;
$tray->manage_screen($screen);
$tray->set_orientation('vertical');

$tray->signal_connect('tray_icon_added', sub {
        # $_[1] is a Gtk2::Socket
});

$tray->signal_connect('tray_icon_removed', sub {
        # $_[1] is a Gtk2::Socket
});

ABSTRACT

The EggTrayManager library is used internally by GNOME to implement the server-side of the Notification Area (or system tray) protocol.
Gtk2::TrayManager allows you to create notification area applications
using Gtk2-Perl.

METHODS

$running = Gtk2::TrayManager->check_running($screen);

This method returns a boolean value indicating whether another program is already managing notifications for the given Gtk2::Gdk::Screen. If
this method returns a false value, then you should give way to the
application that is already running.

$tray = Gtk2::TrayManager->new;

This creates a tray manager object.

$tray->manage_screen($screen);

This tells the tray to manage notifications for the Gtk2::Gdk::Screen
referenced by $screen.

$tray->set_orientation($orientation);

This method tells the tray whether icons are to be arranged vertically or horizontally. $orientation may be either '"vertical"' or
'"horizontal"'.

$title = $tray->get_child_title($child);

This method returns a string containing the title of the icon defined
by $child.

SIGNALS

"tray_icon_added"

Emitted when a client plug (eg one created by Gtk2::TrayIcon) wants to connect. For callbacks connected to this signal, @_ will have
the form

@_ = (

bless( {}, 'Gtk2::TrayManager' ),
bless( {}, 'Gtk2::Socket' )

);

"tray_icon_added"

Emitted when a client plug has disconnected. For callbacks
connected to this signal, @_ will have the form

@_ = (

bless( {}, 'Gtk2::TrayManager' ),
bless( {}, 'Gtk2::Socket' )

);

"message_sent", "message_removed"

The Freedesktop.org specification includes support for "balloon
messages", but these are not currently implemented in
EggTrayManager.

"lost_selection"

As a rule, compliant applications should check to for an already
running manager, and give way to it if it finds one. However, it is possible that your application might have its X selection forcibly removed; this signal is emitted if this should happen.

SEE ALSO

Glib, Gtk, Gtk2::TrayIcon and the System Tray spec at
<http://www.freedesktop.org/Standards/systemtray-spec>.

AUTHOR

Christian Borup <borup at cpan dot org>. Nagging and documentation by
Gavin Brown <gavin.brown@uk.com>

COPYRIGHT AND LICENSE

Copyright 2004 by the gtk2-perl team.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.

You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.

perl v5.10.0 2004-09-09 TrayManager(3pm)