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.