Signal

GtkWidget::query-tooltip

Declaration

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

Description [src]

Emitted when the widget’s tooltip is about to be shown.

This happens when the GtkWidget:has-tooltip property is TRUE and the hover timeout has expired with the cursor hovering “above” widget; or emitted when widget got focus in keyboard mode.

Using the given coordinates, the signal handler should determine whether a tooltip should be shown for widget. 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.

Default handler:

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

Parameters

x

Type: gint

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

y

Type: gint

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

keyboard_mode

Type: gboolean

TRUE if the tooltip was triggered 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.