query_tooltip


Description:

public virtual signal bool query_tooltip (int x, int y, bool keyboard_tooltip, Tooltip tooltip)

Emitted when 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.

Parameters:

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

tooltip

a Tooltip

keyboard_mode

true if the tooltip was triggered using the keyboard

Returns:

true if tooltip should be shown right now, false otherwise.