TIP (non-inheritable)

Text to be shown when the mouse lies over the element. On touch platforms (Android, iOS) the tip is shown after a long-press on the element. It also serves as the element accessible description for screen readers, unless ACCESSIBLEDESCRIPTION is set. Not used for accessibility in Win32, Motif, FLTK, EFL and Haiku.

Value

Text.

Additional Tip Attributes

These attributes affect the TIP display.

TIPBALLOON [Win32 Only]: The tip window will have the appearance of a cartoon "balloon" with rounded corners and a stem pointing to the item. Default: NO.

TIPBALLOONTITLE [Win32 Only]: When using the balloon format, the tip can also have a title in a separate area.

TIPBALLOONTITLEICON [Win32 Only]: When using the balloon format, the tip can also have a pre-defined icon in the title area. Values can be:

"0" - No icon (default)
"1" - Info icon
"2" - Warning icon
"3" - Error Icon

TIPBGCOLOR: The tip background color. Default: "255 255 225" (Light Yellow). Supported in Win32, WinUI, GTK, GTK 4, Motif, Qt, EFL and FLTK.

TIPDELAY [Win32, Motif and FLTK Only]: Time the tip will remain visible. Default: "5000". In Windows the maximum value is 32767 milliseconds.

TIPFGCOLOR: The tip text color. Default: "0 0 0" (Black). Supported in Win32, WinUI, GTK, GTK 4, Motif, Qt, EFL and FLTK.

TIPFONT: The font for the tip text. If not defined the font used for the text is the same as the FONT attribute for the element. If the value is SYSTEM then, no font is selected and the default system font for the tip will be used. Supported in Win32, WinUI, GTK, GTK 4, Motif, Qt, EFL and FLTK.

TIPICON [GTK, GTK 4 and EFL Only]: name of an image to be displayed in the TIP. See IupImage.

TIPMARKUP [GTK and GTK 4 Only]: allows the tip string to contain Pango markup commands. Can be "YES" or "NO". Default: "NO". Must be set before setting the TIP attribute.

TIPRECT (non-inheritable): Specifies a rectangle inside the element where the tip will be activated. Format: "%d %d %d %d"="x1 y1 x2 y2". Default: all the element area. Not supported in EFL, Haiku, Android, iOS and WebAssembly.

TIPVISIBLE: Shows or hides the tip under the mouse cursor. Use values "YES" or "NO". Returns the current visible state. Reading the state is not supported in GTK 4.

Additional Tip Callbacks

TIPS_CB: Action before a tip is displayed.

int function(Ihandle* ih, int x, int y);

ih: identifier of the element that activated the event.
x, y: cursor position relative to the top-left corner of the element

Not supported in FLTK, Haiku, Android, iOS and WebAssembly.

Affects

All controls that have visual representation, except menus.