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)
GObject +----GtkStatusIcon
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.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.activate(status.icon, user.data)
status.icon
user.data
button-press-event(status.icon, event, user.data)
status.icon
event
GdkEventButton
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked
for the event. FALSE
to propagate the event further. button-release-event(status.icon, event, user.data)
status.icon
event
GdkEventButton
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked
for the event. FALSE
to propagate the event further. popup-menu(status.icon, button, activate.time, user.data)
button
and activate.time
parameters should be
passed as the last to arguments to gtkMenuPopup
. Unlike most G_SIGNAL_ACTION signals, this signal is meant to
be used by applications and should be wrapped by language bindings.
Since 2.10 status.icon
button
activate.time
user.data
query-tooltip(status.icon, x, y, keyboard.mode, tooltip, user.data)
"gtk-tooltip-timeout"
has expired with the
cursor hovering above status.icon
; or emitted when status.icon
got
focus in keyboard mode. Using the given coordinates, the signal handler should determine
whether a tooltip should be shown for status.icon
. If this is
the case TRUE
should be returned, FALSE
otherwise. Note that if
keyboard.mode
is TRUE
, the values of x
and y
are undefined and
should not be used. The signal handler is free to manipulate tooltip
with the therefore
destined function calls. Whether this signal is emitted is platform-dependent.
For plain text tooltips, use "tooltip-text"
in preference.
Since 2.16 status.icon
x
status.icon
y
status.icon
keyboard.mode
TRUE
if the tooltip was trigged using the keyboardtooltip
GtkTooltip
user.data
TRUE
if tooltip
should be shown right now, FALSE
otherwise. scroll-event(status.icon, event, user.data)
status.icon
event
GdkEventScroll
which triggered this signaluser.data
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further. size-changed(status.icon, size, user.data)
status.icon
size
user.data
TRUE
if the icon was updated for the new
size. Otherwise, GTK+ will scale the icon as necessary. blinking
[logical : Read / Write]embedded
[logical : Read]TRUE
if the statusicon is embedded in a notification area.
Default value: FALSE Since 2.12 file
[character : * : Write]gicon
[GIcon
: * : Read / Write]GIcon
displayed in the GtkStatusIcon
. For themed icons,
the image will be updated automatically if the theme changes.
Since 2.14 has-tooltip
[logical : Read / Write]"query-tooltip"
on
status.icon
. A value of TRUE
indicates that status.icon
can have a
tooltip, in this case the status icon will be queried using
"query-tooltip"
to determine whether it will provide a
tooltip or not. Note that setting this property to TRUE
for the first time will change
the event masks of the windows of this status icon to include leave-notify
and motion-notify events. This will not be undone when the property is set
to FALSE
again. Whether this property is respected is platform dependent.
For plain text tooltips, use "tooltip-text"
in preference.
Default value: FALSE Since 2.16 icon-name
[character : * : Read / Write]orientation
[GtkOrientation
: Read]pixbuf
[GdkPixbuf
: * : Read / Write]screen
[GdkScreen
: * : Read / Write]size
[integer : Read]stock
[character : * : Read / Write]storage-type
[GtkImageType
: Read]title
[character : * : Read / Write]tooltip-markup
[character : * : Read / Write]gtkTooltipSetMarkup
. This is a convenience property which will take care of getting the
tooltip shown if the given string is not NULL
.
"has-tooltip"
will automatically be set to TRUE
and
the default handler for the "query-tooltip"
signal
will take care of displaying the tooltip. On some platforms, embedded markup will be ignored.
Default value: NULL Since 2.16 tooltip-text
[character : * : Read / Write]gtkTooltipSetText
. This is a convenience property which will take care of getting the
tooltip shown if the given string is not NULL
.
"has-tooltip"
will automatically be set to TRUE
and
the default handler for the "query-tooltip"
signal
will take care of displaying the tooltip. Note that some platforms have limitations on the length of tooltips
that they allow on status icons, e.g. Windows only shows the first
64 characters.
Default value: NULL Since 2.16 visible
[logical : Read / Write]