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 widgets 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 |
Parameters
x |
gint |
The x coordinate of the cursor position where the request has
been emitted, relative to |
|
y |
gint |
The y coordinate of the cursor position where the request has
been emitted, relative to |
|
keyboard_mode |
gboolean |
|
|
tooltip |
GtkTooltip |
A |
|
The data is owned by the caller of the function. |