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-
Type:
gintThe x coordinate of the cursor position where the request has been emitted, relative to
widget‘s left side. y-
Type:
gintThe y coordinate of the cursor position where the request has been emitted, relative to
widget‘s top. keyboard_mode-
Type:
gbooleanTRUEif the tooltip was triggered using the keyboard. tooltip-
Type:
GtkTooltipA
GtkTooltipThe data is owned by the caller of the function.