Blitz3D+ Command Reference

SetGadgetToolTip gadget,text$

Parameters

gadget - any gadget that belongs to a window

text$ - tooltip text; "" removes the tooltip

Description

Gives a gadget a native hover tooltip.

Requires Extended language mode.

The text appears in the standard yellow bubble when the mouse rests on the gadget - the natural place for a one-line explanation of an editor control ("Resize the preview from 40 to 160 percent"). Long text wraps to a sensible width automatically, and UTF-8 means any language works.

Tooltips are pure presentation: they post no events, they are not the gadget's text, and they disappear on their own. Each top-level window runs one shared tooltip host for all its gadgets, and a gadget's tip is cleaned up automatically when the gadget is freed. Calling again replaces the text; an empty string removes the tip.

For placeholder text inside an empty text field or combo box, use SetGadgetHint instead; for per-button toolbar tips from one list, SetToolBarTips.

See it working in the native input controls sample.

See also: SetGadgetHint, SetToolBarTips, SetStatusText.

Index