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 GtkWidget:has-tooltip 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()`.
Available since:	2.12

Parameters

`x`	`gint`
	The x coordinate of the cursor position where the request has been emitted, relative to `widget`‘s left side.
`y`	`gint`
	The y coordinate of the cursor position where the request has been emitted, relative to `widget`‘s top.
`keyboard_mode`	`gboolean`
	`TRUE` if the tooltip was triggered using the keyboard.
`tooltip`	`GtkTooltip`
	A `GtkTooltip`.
	The data is owned by the caller of the function.

Return value

Returns:	`gboolean`
	`TRUE` if `tooltip` should be shown right now, `FALSE` otherwise.