GtkStatusIcon: GtkStatusIcon
Description
Display an icon in the system trayMethods and Functions
gtkStatusIconNew()
gtkStatusIconNewFromPixbuf(pixbuf)
gtkStatusIconNewFromFile(filename)
gtkStatusIconNewFromStock(stock.id)
gtkStatusIconNewFromIconName(icon.name)
gtkStatusIconNewFromGicon(icon)
gtkStatusIconSetFromPixbuf(object, pixbuf)
gtkStatusIconSetFromFile(object, filename)
gtkStatusIconSetFromStock(object, stock.id)
gtkStatusIconSetFromIconName(object, icon.name)
gtkStatusIconSetFromGicon(object, icon)
gtkStatusIconGetStorageType(object)
gtkStatusIconGetPixbuf(object)
gtkStatusIconGetStock(object)
gtkStatusIconGetIconName(object)
gtkStatusIconGetGicon(object)
gtkStatusIconGetSize(object)
gtkStatusIconSetScreen(object, screen)
gtkStatusIconGetScreen(object)
gtkStatusIconSetTooltip(object, tooltip.text)
gtkStatusIconSetTooltip(object, tooltip.text)
gtkStatusIconSetTooltipText(object, text)
gtkStatusIconGetTooltipText(object)
gtkStatusIconSetTooltipMarkup(object, markup = NULL)
gtkStatusIconGetTooltipMarkup(object)
gtkStatusIconSetHasTooltip(object, has.tooltip)
gtkStatusIconGetHasTooltip(object)
gtkStatusIconSetTitle(object, title)
gtkStatusIconGetTitle(object)
gtkStatusIconSetName(object, name)
gtkStatusIconSetVisible(object, visible)
gtkStatusIconGetVisible(object)
gtkStatusIconSetBlinking(object, blinking)
gtkStatusIconGetBlinking(object)
gtkStatusIconIsEmbedded(object)
gtkStatusIconPositionMenu(menu, user.data)
gtkStatusIconGetGeometry(object)
gtkStatusIconGetX11WindowId(object)
gtkStatusIcon(icon)
Hierarchy
GObject
+----GtkStatusIconDetailed Description
The "system tray" or notification area is normally used for transient icons
that indicate some special state. For example, a system tray icon might
appear to tell the user that they have new mail, or have an incoming instant
message, or something along those lines. The basic idea is that creating an
icon in the notification area is less annoying than popping up a dialog.
A GtkStatusIcon
object can be used to display an icon in a "system tray".
The icon can have a tooltip, and the user can interact with it by
activating it or popping up a context menu. Critical information should
not solely be displayed in a GtkStatusIcon
, since it may not be
visible (e.g. when the user doesn't have a notification area on his panel).
This can be checked with gtkStatusIconIsEmbedded
.
On X11, the implementation follows the freedesktop.org "System Tray"
specification (http://www.freedesktop.org/wiki/Standards/systemtray-spec). Implementations of the "tray" side of this specification can
be found e.g. in the GNOME and KDE panel applications.
Note that a GtkStatusIcon is not a widget, but just
a GObject
. Making it a widget would be impractical, since the system tray
on Win32 doesn't allow to embed arbitrary widgets.Convenient Construction
gtkStatusIcon
is the result of collapsing the constructors of GtkStatusIcon
(gtkStatusIconNew
, gtkStatusIconNewFromGicon
) and accepts a subset of its arguments matching the required arguments of one of its delegate constructors.References
http://library.gnome.org/devel//gtk/GtkStatusIcon.html