|
|
chvirprt and tray 1
|
|
TrayManager(3pm) User Contributed Perl Documentation 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! "; 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 <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.14.2 2004-09-09 TrayManager(3pm)
