Obtains information about the location of the status icon
on screen. This information can be used to e.g. position
popups like notification bubbles.
See gtk_status_icon_position_menu() for a more convenient
alternative for positioning menus.
Note that some platforms do not allow GTK+ to provide
this information, and even on platforms that do allow it,
the information is not reliable unless the status icon
is embedded in a notification area, see
gtk_status_icon_is_embedded().
been filled in

Parameters:

Object out_values

Gdk.Screen screen

cairo.RectangleInt area

Gtk.Orientation orientation

Returns:

gboolean TRUE if the location information has

Retrieves the GIcon being displayed by the GtkStatusIcon.
The storage type of the status icon must be GTK_IMAGE_EMPTY or
GTK_IMAGE_GICON (see gtk_status_icon_get_storage_type()).
The caller of this function does not own a reference to the
returned GIcon.
If this function fails, icon is left unchanged;

Returns:

Gio.Icon the displayed icon, or NULL if the image is empty

Returns the current value of the has-tooltip property.
See GtkStatusIcon:has-tooltip for more information.

Returns:

gboolean current value of has-tooltip on status_icon.

Gets the name of the icon being displayed by the GtkStatusIcon.
The storage type of the status icon must be GTK_IMAGE_EMPTY or
GTK_IMAGE_ICON_NAME (see gtk_status_icon_get_storage_type()).
The returned string is owned by the GtkStatusIcon and should not
be freed or modified.

Returns:

String name of the displayed icon, or NULL if the image is empty.

Gets the GdkPixbuf being displayed by the GtkStatusIcon.
The storage type of the status icon must be GTK_IMAGE_EMPTY or
GTK_IMAGE_PIXBUF (see gtk_status_icon_get_storage_type()).
The caller of this function does not own a reference to the
returned pixbuf.
or NULL if the image is empty.

Returns:

GdkPixbuf.Pixbuf the displayed pixbuf,

Returns the GdkScreen associated with status_icon.

Returns:

Gdk.Screen a GdkScreen.

Gets the size in pixels that is available for the image.
Stock icons and named icons adapt their size automatically
if the size of the notification area changes. For other
storage types, the size-changed signal can be used to
react to size changes.
Note that the returned size is only meaningful while the
status icon is embedded (see gtk_status_icon_is_embedded()).

Returns:

gint32 the size that is available for the image

Gets the id of the stock icon being displayed by the GtkStatusIcon.
The storage type of the status icon must be GTK_IMAGE_EMPTY or
GTK_IMAGE_STOCK (see gtk_status_icon_get_storage_type()).
The returned string is owned by the GtkStatusIcon and should not
be freed or modified.
or NULL if the image is empty.

Returns:

String stock id of the displayed stock icon,

Gets the type of representation being used by the GtkStatusIcon
to store image data. If the GtkStatusIcon has no image data,
the return value will be GTK_IMAGE_EMPTY.

Returns:

Gtk.ImageType the image representation being used

Gets the title of this tray icon. See gtk_status_icon_set_title().

Returns:

String the title of the status icon

Gets the contents of the tooltip for status_icon.
returned string with g_free() when done.

Returns:

String the tooltip text, or NULL. You should free the

Gets the contents of the tooltip for status_icon.
returned string with g_free() when done.

Returns:

String the tooltip text, or NULL. You should free the

Returns whether the status icon is visible or not.
Note that being visible does not guarantee that
the user can actually see the icon, see also
gtk_status_icon_is_embedded().

Returns:

gboolean TRUE if the status icon is visible

This function is only useful on the X11/freedesktop.org platform.
It returns a window ID for the widget in the underlying
status icon implementation. This is useful for the Galago
notification service, which can send a window ID in the protocol
in order for the server to position notification windows
pointing to a status icon reliably.
This function is not intended for other use cases which are
more likely to be met by one of the non-X11 specific methods, such
as gtk_status_icon_position_menu().
underlying X11 Window

Returns:

guint32 An 32 bit unsigned integer identifier for the

Returns whether the status icon is embedded in a notification
area.
a notification area.

Returns:

gboolean TRUE if the status icon is embedded in

Makes status_icon display the file filename.
See gtk_status_icon_new_from_file() for details.

Parameters:

String filename Required (not null)

a filename

Returns:

none

Makes status_icon display the GIcon.
See gtk_status_icon_new_from_gicon() for details.

Parameters:

Gio.Icon icon Required (not null)

a GIcon

Returns:

none

Makes status_icon display the icon named icon_name from the
current icon theme.
See gtk_status_icon_new_from_icon_name() for details.

Parameters:

String icon_name Required (not null)

an icon name

Returns:

none

Makes status_icon display pixbuf.
See gtk_status_icon_new_from_pixbuf() for details.

Parameters:

GdkPixbuf.Pixbuf pixbuf

a GdkPixbuf or NULL

Returns:

none

Makes status_icon display the stock icon with the id stock_id.
See gtk_status_icon_new_from_stock() for details.

Parameters:

String stock_id Required (not null)

a stock icon id

Returns:

none

Sets the has-tooltip property on status_icon to has_tooltip.
See GtkStatusIcon:has-tooltip for more information.

Parameters:

gboolean has_tooltip Required (not null)

whether or not status_icon has a tooltip

Returns:

none

Sets the name of this tray icon.
This should be a string identifying this icon. It is may be
used for sorting the icons in the tray and will not be shown to
the user.

Parameters:

String name Required (not null)

the name

Returns:

none

Sets the GdkScreen where status_icon is displayed; if
the icon is already mapped, it will be unmapped, and
then remapped on the new screen.

Parameters:

Gdk.Screen screen Required (not null)

a GdkScreen

Returns:

none

Sets the title of this tray icon.
This should be a short, human-readable, localized string
describing the tray icon. It may be used by tools like screen
readers to render the tray icon.

Parameters:

String title Required (not null)

the title

Returns:

none

Sets markup as the contents of the tooltip, which is marked up with
the Pango text markup language.
This function will take care of setting GtkStatusIcon:has-tooltip to TRUE
and of the default handler for the GtkStatusIcon::query-tooltip signal.
See also the GtkStatusIcon:tooltip-markup property and
gtk_tooltip_set_markup().

Parameters:

String markup

the contents of the tooltip for status_icon, or NULL

Returns:

none

Sets text as the contents of the tooltip.
This function will take care of setting GtkStatusIcon:has-tooltip to
TRUE and of the default handler for the GtkStatusIcon::query-tooltip
signal.
See also the GtkStatusIcon:tooltip-text property and
gtk_tooltip_set_text().

Parameters:

String text Required (not null)

the contents of the tooltip for status_icon

Returns:

none

Shows or hides a status icon.

Parameters:

gboolean visible Required (not null)

TRUE to show the status icon, FALSE to hide it

Returns:

none

Gets emitted when the user activates the status icon.
If and how status icons can activated is platform-dependent.
Unlike most G_SIGNAL_ACTION signals, this signal is meant to
be used by applications and should be wrapped by language bindings.

Parameters:

Gtk.StatusIcon self

Returns:

{none}

The ::button-press-event signal will be emitted when a button
(typically from a mouse) is pressed.
Whether this event is emitted is platform-dependent. Use the ::activate
and ::popup-menu signals in preference.
for the event. FALSE to propagate the event further.

Parameters:

Gtk.StatusIcon self

Gdk.EventButton event

Returns:

{gboolean}

The ::button-release-event signal will be emitted when a button
(typically from a mouse) is released.
Whether this event is emitted is platform-dependent. Use the ::activate
and ::popup-menu signals in preference.
for the event. FALSE to propagate the event further.

Parameters:

Gtk.StatusIcon self

Gdk.EventButton event

Returns:

{gboolean}

Gets emitted when the user brings up the context menu
of the status icon. Whether status icons can have context
menus and how these are activated is platform-dependent.
The button and activate_time parameters should be
passed as the last to arguments to gtk_menu_popup().
Unlike most G_SIGNAL_ACTION signals, this signal is meant to
be used by applications and should be wrapped by language bindings.

Parameters:

Gtk.StatusIcon self

guint32 button

guint32 activate_time

Returns:

{none}

Emitted when the GtkSettings: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
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 GtkStatusIcon:tooltip-text in preference.

Parameters:

Gtk.StatusIcon self

gint32 x

gint32 y

gboolean keyboard_mode

Gtk.Tooltip tooltip

Returns:

{gboolean}

The ::scroll-event signal is emitted when a button in the 4 to 7
range is pressed. Wheel mice are usually configured to generate
button press events for buttons 4 and 5 when the wheel is turned.
Whether this event is emitted is platform-dependent.
FALSE to propagate the event further.

Parameters:

Gtk.StatusIcon self

Gdk.EventScroll event

Returns:

{gboolean}

Gets emitted when the size available for the image
changes, e.g. because the notification area got resized.
size. Otherwise, GTK+ will scale the icon as necessary.

Parameters:

Gtk.StatusIcon self

gint32 size

Returns:

{gboolean}