Gtk.Widget::query-tooltip
function callback(widget, x:Number, y:Number, keyboard_mode:Boolean, tooltip:Gtk.Tooltip, ):Boolean;
Emitted when Gtk.has-tooltip is true and the Gtk.Settings:gtk-tooltip-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.
Since 2.12
- widget
instance of Gtk.Widget that is emitting the signal
- x
the x coordinate of the cursor position where the request has been emitted, relative to @widget's left side
- y
the y coordinate of the cursor position where the request has been emitted, relative to @widget's top
- keyboard_mode
true if the tooltip was trigged using the keyboard
- tooltip
- Returns
true if tooltip should be shown right now, false otherwise.