Signal

GtkStatusIcon::query-tooltip

since: 2.16

Declaration

gboolean
query_tooltip (
  GtkStatusIcon* self,
  gint x,
  gint y,
  gboolean keyboard_mode,
  GtkTooltip* tooltip,
  gpointer user_data
)

Description [src]

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

Default handler:

The default handler is called after the handlers added via g_signal_connect().

Available since: 2.16

Parameters

x

Type: gint

The x coordinate of the cursor position where the request has been emitted, relative to status_icon.

y

Type: gint

The y coordinate of the cursor position where the request has been emitted, relative to status_icon.

keyboard_mode

Type: gboolean

TRUE if the tooltip was trigged using the keyboard.

tooltip

Type: GtkTooltip

A GtkTooltip.

The data is owned by the caller of the function.

Return value

Type: gboolean

TRUE if tooltip should be shown right now, FALSE otherwise.