XAppStatusIconMonitor

XAppStatusIconMonitor — Looks for XAppStatusIcons on DBUS and communicates info to an applet to represent the icons.

Functions

Signals

Types and Values

Object Hierarchy

    GObject
    ╰── XAppStatusIconMonitor

Description

The XAppStatusIconMonitor is intended to be utilized by some status applet to display info about an app.

The simplest way to use is to make a new instance of this monitor, and connect to the “icon-added” and “icon-removed” signals. The received object for both of these signals is an XAppStatusIconInterfaceProxy. It represents an application's XAppStatusIcon, and has properties available for describing the icon name, tooltip, label and visibility.

The proxy also provides methods to handle clicks, which can be called by the applet, to request that the app display its menu.

Functions

xapp_status_icon_monitor_new ()

XAppStatusIconMonitor *
xapp_status_icon_monitor_new (void);

Creates a new monitor.

Returns

a new XAppStatusIconMonitor. Use g_object_unref when finished.

[transfer full]

Since: 1.6


xapp_status_icon_monitor_list_icons ()

GList *
xapp_status_icon_monitor_list_icons (XAppStatusIconMonitor *monitor);

List known icon proxies.

Parameters

monitor

a XAppStatusIconMonitor

 

Returns

a GList of icons.

[element-type XAppStatusIconMonitor][transfer container]

Since: 1.6

Types and Values

XAPP_TYPE_STATUS_ICON_MONITOR

#define XAPP_TYPE_STATUS_ICON_MONITOR   (xapp_status_icon_monitor_get_type ())

XAppStatusIconMonitor

typedef struct _XAppStatusIconMonitor XAppStatusIconMonitor;

Signal Details

The “icon-added” signal

void
user_function (XAppStatusIconMonitor        *monitor,
               XAppStatusIconInterfaceProxy *proxy,
               gpointer                      user_data)

This signal is emitted by the monitor when it has discovered a new XAppStatusIcon on the bus.

Parameters

monitor

the XAppStatusIconMonitor

 

proxy

the interface proxy for the XAppStatusIcon that has been added.

 

user_data

user data set when the signal handler was connected.

 

Flags: Action


The “icon-removed” signal

void
user_function (XAppStatusIconMonitor        *monitor,
               XAppStatusIconInterfaceProxy *proxy,
               gpointer                      user_data)

This signal is emitted by the monitor when an XAppStatusIcon has disappeared from the bus.

Parameters

monitor

the XAppStatusIconMonitor

 

proxy

the XAppStatusIcon proxy that has been removed.

 

user_data

user data set when the signal handler was connected.

 

Flags: Action