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.