Main Page | Data Structures | File List | Data Fields | Globals | Related Pages

systray.c File Reference

Interface to the system tray. More...

#include "rox-clib.h"
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <gdk/gdk.h>
#include <gdk/gdkx.h>
#include <gtk/gtk.h>
#include "choices.h"
#include "rox.h"
#include "systray.h"

Functions

void rox_systray_init (void)
GtkWidget * rox_systray_new (void)
GtkWidget * rox_systray_new_on_screen (GdkScreen *screen)
int rox_systray_send_message (GtkWidget *systray, const char *message, unsigned usec)
void rox_systray_cancel_message (GtkWidget *systray, int id)


Detailed Description

Interface to the system tray.


Function Documentation

void rox_systray_cancel_message GtkWidget *  systray,
int  id
 

Cancel a balloon help message.

Parameters:
[in] systray system tray container as used in rox_systray_send_message().
[in] id id code returned by rox_systray_send_message().

void rox_systray_init void   ) 
 

Initialize the system tray interface.

GtkWidget* rox_systray_new void   ) 
 

Create a new system tray widget for the default screen. A container widget is returned, you should add whatever widgets are needed to it. rox_systray_init() must be called first.

Returns:
a pointer to a GtkContainer widget, or NULL if no system tray manager was found.

GtkWidget* rox_systray_new_on_screen GdkScreen *  screen  ) 
 

Create a new system tray widget for the specified screen. A container widget is returned, you should add whatever widgets are needed to it. rox_systray_init() must be called first.

Parameters:
[in] screen screen where the system tray manager is running
Returns:
a pointer to a GtkContainer widget, or NULL if no system tray manager was found for the screen.

int rox_systray_send_message GtkWidget *  systray,
const char *  message,
unsigned  usec
 

Send a balloon message to the system tray icon.

Parameters:
[in] systray system tray container as returned by rox_systray_new() or rox_systray_new_on_screen().
[in] message message to display
[in] usec time in micro-seconds to display balloon message, or 0 for no time out.
Returns:
id code for message, 0 returned for failure


Generated on Sat Oct 22 17:49:14 2005 for ROX-CLib by doxygen 1.3.8