2007年5月4日星期五

把你的程序加入到系统托盘里

http://www.gnome-cn.org/documents/tutorial/system-tray-icon-application/add-tray-widget/tutorialpage_view

介绍如何写一个支持系统通知功能的 GNOME 程序,也就是在通知区域显示一个小图标,用于显示程序状态或提供快捷菜单。

简介

介绍"系统托盘"/"通知区域"的基本概念。

" 系统托盘"是一个运行在指定的 X 屏幕(注1)上的应用程序,它显示由其它正在运行的应用程序提供的小图标,以此来提供通知功能。在 Windows XP 里称之为"通知区域"。受 KDE 的启发,在 Freedesktop 上的 "系统托盘协议规范":http://freedesktop.org/wiki/Standards_2fsystemtray_2dspec 中使用"系统托盘(System Tray)" 这一称法,所以我在此文中也称之为"系统托盘"。

在 GNOME 桌面系统中,系统托盘显示在桌面上的菜单栏(gnome-panel)上,如果你的菜单栏上默认没有"系统托盘",那么可以通过右键点菜单栏->添加到菜单栏...,然后选择"系统通知区域“来添加。

我们常见的使用了系统托盘的应用程序有:"星际译王":http://stardict.sourceforge.net/, Gaim , LumaQQ 等。如下图:

GNOME system tray

注1: Xwindow 系统可以同时支持多个屏幕。

资料:

System Tray Protocol Specification

http://standards.freedesktop.org/systemtray-spec/0.2/

gnome-panel 中通知区域的实现

http://cvs.gnome.org/viewcvs/gnome-panel/applets/notification_area/

应用程序中要用的 tray 代码

http://cvs.gnome.org/viewcvs/libegg/libegg/tray/

把系统通知控件加入到你的源码中

获取系统通知控件源码,添加到你的源码中。

前言

在 GNOME 系统中,系统通知功能分两部分实现:1)系统菜单栏的上的通知区域,这个是在 gnome-panel/applets/notification_area , 这相当于系统通知的服务端,所有通知图标都会显示在这块区域里,具体效果就是上一页中的截图所示; 2)应用程序端,GNOME 环境中所有使用了系统通知功能的程序,都自己包含了来自 libegg 中的两个实现系统通知功能应用程序端接口的库:eggtrayicon.c, 'eggtrayicon.h'。 libegg 是一个包含了许多没有纳入但可能在末来某个时候被纳入到 GNOME 正式发行的包里的功能库。因此,我们也可以要做类似的工作:

  1. 获取系统通知控件源码

    直接从 GNOME 的 cvs 里获取:libegg/libegg/tray/ 下载其中的 eggtrayicon.c, eggtrayicon.h

    或者使用如下的 cvs 命令:

        cvs -z3 -q -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co libegg/libegg/tray

    cd libegg/libegg/tray/

    cp eggtrayicon.* ~/Projects/gnome-notification-area-demo/src/

    如果上述两个方法都无法获取到,请使用本教程末尾的连接下载。

    然后把 eggtrayicon.c, eggtrayicon.h 复制到你的源码目录里。

  2. eggtrayicon.c, eggtrayicon.h 添加到你的源码目录里。

    如果你使用的 anjuta 1.x 集成开发环境,那么,把这两个文件放到你的源码目录里的 src 里,然后在 anjuta 打开你的项目,然后选择菜单->项目->添加文件->源文件,然后选中你的项目的源码目录里的 src 下的 eggtrayicon.c, 'eggtrayicon.h',占击确定就完成了。如下图:

    2-2-1.png

    这时你可以在项目窗口里看到这两个文件。

    2-2-2.png

    注:此时 anjuta 所做的就是把 eggtrayicon.c, eggtrayicon.h 添加到你的源码目录里的 Makefile.am 中了。

实现你自己的通知功能图标

在你的源码里实现你自己的通知功能图标

上一步咱们已经完成了必要的准备工作,现在就需要在咱们已经的代码里调用 eggtrayicon.h 里的函数来实现我们的通知功能了。

  1. 首先在你的源码里引用头文件 eggtrayicon.h
  2. 调用 GtkWidget *egg_tray_icon_new(void) 来创建一个通知图标控件,如 tray_icon.
  3. tray_icon 加入自己的控件,如图标或者其它.

创建通知图标的源码:

   #include "eggtrayicon.h"

void
create_tray (tray_demo * tray)
{
GtkWidget *image;
GtkWidget *event_box;
GtkTooltips *tooltips;
EggTrayIcon *tray_icon;

tooltips = gtk_tooltips_new ();
tray_icon = egg_tray_icon_new ("Tray icon demo");
event_box = gtk_event_box_new ();
gtk_container_add (GTK_CONTAINER (tray_icon), event_box);
g_signal_connect (G_OBJECT (event_box), "button-press-event",
G_CALLBACK (tray_button_press_event_cb), tray);
gtk_tooltips_set_tip (GTK_TOOLTIPS(tooltips), event_box, _("Try a left/right click"), NULL) ;

image = load_image (GCN_ICON);
gtk_container_add (GTK_CONTAINER (event_box), image);

gtk_widget_show_all (GTK_WIDGET (tray_icon));

return;
}

sct1

演示程程序:"源码":gnome-notification-area-demo-0.1.tar.gz

下载后的使用方法:

   tar zxf gnome-notification-area-demo-0.1.tar.gz
cd gnome-notification-area-demo-0.1/
./configure
make install
gnome-notification-area-demo

没有评论: