Gtk.StatusIcon::query-tooltip
function callback(status_icon, x:Number, y:Number, keyboard_mode:Boolean, tooltip:Gtk.Tooltip, ):Boolean;
Emitted when the Gtk.Settings:gtk-tooltip-timeout has expired with the cursor hovering above @status_icon; or emitted when @status_icon got focus in keyboard mode.
Using the given coordinates, the signal handler should determine whether a tooltip should be shown for @status_icon. 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.
Whether this signal is emitted is platform-dependent. For plain text tooltips, use Gtk.tooltip-text in preference.
Since 2.16
- status_icon
instance of Gtk.StatusIcon that is emitting the signal
- x
the x coordinate of the cursor position where the request has been emitted, relative to @status_icon
- y
the y coordinate of the cursor position where the request has been emitted, relative to @status_icon
- keyboard_mode
true if the tooltip was trigged using the keyboard
- tooltip
- Returns
true if tooltip should be shown right now, false otherwise.